Autobump
In official repositories, BrewTestBot automatically checks for available updates to packages that are in Homebrew’s “autobump list”. These packages do not need to be bumped (i.e. have their version number increased) manually by a contributor. Instead, every 3 hours, a GitHub Action opens a new pull request to upgrade them to the latest version, if needed.
Excluding packages from autobumping
By default, all new formulae and casks from the Homebrew/core and Homebrew/cask repositories are autobumped. To exclude a package from the autobump list, it must have one of the following:
- an active
deprecate!
ordisable!
call - a
livecheck do
block containing askip
call - a
no_autobump!
call
Other formula and cask specific reasons for why a package is not autobumped are listed in the Formula Cookbook and Cask Cookbook respectively.
Autobump exclusion reasons
When using no_autobump!
, a reason for exclusion must be provided.
There are two ways to indicate the reason. The preferred way is to use a pre-existing symbol, which can be found in NO_AUTOBUMP_REASONS_LIST
, for example:
no_autobump! because: :bumped_by_upstream
If these pre-existing reasons do not fit, a custom reason can be specified:
no_autobump! because: "some unique reason"
If there are multiple packages with a similar custom reason, it can be added as a new symbol to NO_AUTOBUMP_REASONS_LIST
.