Homebrew tap setup#

This folder is a reference bundle, rendered here for convenience — it is not consumed by nur itself. Copy its contents into your hasansezertasan/homebrew-tap repository to receive automated Homebrew formula bumps on every release.

How it works#

On each release, this project’s bump-homebrew job (in release.yml) sends a repository_dispatch event to hasansezertasan/homebrew-tap. The listener workflow in this folder receives that event, resolves the new version, bumps the formula, audits it, and opens a pull request against the tap — all inside the tap repository, using the tap’s own GITHUB_TOKEN.

One-time tap setup#

Create the tap repository:

gh repo create hasansezertasan/homebrew-tap --public \
  --description "Homebrew tap for hasansezertasan packages"

Clone the tap locally and cd into it — the bootstrap commands below operate on files inside this checkout:
```
gh repo clone hasansezertasan/homebrew-tap
cd homebrew-tap
```
Bootstrap the initial formula:
```
brew tap hasansezertasan/tap
brew create --set-name nur <pypi-sdist-url> --tap hasansezertasan/tap
brew update-python-resources hasansezertasan/tap/nur
```
These write Formula/nur.rb into brew’s own checkout of the tap ($(brew --repository hasansezertasan/tap)), not this clone; update-python-resources fills in the Python resource blocks for the formula’s dependencies. Copy the finished formula into this clone’s Formula/ directory before committing.
Commit the listener workflow from this folder, update-formula-dispatch.yml, to the tap’s .github/workflows/ directory.
Push everything so the tap repository actually contains the listener and the initial formula before any release fires a dispatch:
```
git add -A
git commit -m "Add nur + release listener"
git push
```

Token setup (in this project’s repo)#

In this project’s repository — hasansezertasan/nur — add a fine-grained personal access token as the HOMEBREW_TAP_TOKEN secret, scoped to hasansezertasan/homebrew-tap with Contents: write permission only. That is all the POST /dispatches API requires; the tap opens its own pull request with its own GITHUB_TOKEN, so Pull requests: write is not needed on the PAT.

gh secret set HOMEBREW_TAP_TOKEN --repo hasansezertasan/nur

When HOMEBREW_TAP_TOKEN is unset, the bump-homebrew job skips with a notice — it never fails the release.

Reference implementation#

hasansezertasan/homebrew-tap is a working tap built with this same listener, kept as a live reference.