brew/docs/Brew-Test-Bot-For-Core-Contributors.md

Brew Test Bot For Core Contributors

If a build has run and passed on brew test-bot then it can be used to quickly bottle formulae.

Bottling

If a pull request is correct and doesn't need any modifications to commit messages or otherwise:

1. Ensure the job has already completed successfully.
2. Run brew pr-publish 12345 where 12345 is the pull request number (or URL).
   • Approving a PR for an existing formula will automatically publish the bottles and close the PR, taking care of this step.
3. Watch the actions queue to ensure your job finishes. BrewTestBot will usually notify you of failures with a ping as well.

If a pull request needs its commits squashed or its commit messages reformatted to follow our style:

1. Ensure the job has already completed successfully.
2. Run brew pr-publish --autosquash 12345 where 12345 is the pull request number (or URL). For revision bumps, rebuilds, and formula deletions, you can optionally include a --message argument to explain the change.

If a pull request needs its commit messages changed in a way that autosquash doesn't support:

1. Ensure the job has already completed successfully.
2. Run brew pr-pull 12345 where 12345 is the pull request number (or URL).
3. Amend any relevant commits if needed, then run git push to push the commits.