How to test formula before upstream release (case gitui)

[peso]

Output of brew config

HOMEBREW_VERSION: 4.4.26
ORIGIN: https://github.com/Homebrew/brew
HEAD: f1041842141f20bc701b522d4371d7843d905580
Last commit: 3 days ago
Branch: stable
Core tap HEAD: 72f7584ed169284e4364fbfd6e2c9030f441990e
Core tap last commit: 25 minutes ago
Core tap JSON: 27 Mar 05:08 UTC
Core cask tap HEAD: 71c4d50bcc9873689689b8f91608dd2aa92d04c9
Core cask tap last commit: 30 minutes ago
Core cask tap JSON: 27 Mar 05:08 UTC
HOMEBREW_PREFIX: /opt/homebrew
HOMEBREW_CASK_OPTS: ["--no-quarantine"]
HOMEBREW_COLOR: set
HOMEBREW_MAKE_JOBS: 3
HOMEBREW_NO_AUTO_UPDATE: set
HOMEBREW_NO_INSTALL_CLEANUP: set
Homebrew Ruby: 3.3.7 => /opt/homebrew/Library/Homebrew/vendor/portable-ruby/3.3.7/bin/ruby
CPU: 3-core 64-bit dunno
Clang: 15.0.0 build 1500
Git: 2.49.0 => /opt/homebrew/bin/git
Curl: 8.7.1 => /usr/bin/curl
macOS: 14.7.4-arm64
CLT: 16.2.0.0.1.1733547573
Xcode: 15.4 => /Applications/Xcode_15.4.app/Contents/Developer
Rosetta 2: false

Output of brew doctor

Please note that these warnings are just used to help the Homebrew maintainers
with debugging if you file an issue. If everything you use Homebrew for is
working fine: please don't worry or file an issue; just ignore this. Thanks!
Warning: Some installed formulae are deprecated or disabled.
You should find replacements for the following formulae:
  [email protected]

Warning: The following formulae have the same name as core formulae:
  aws/tap/eksctl
  hashicorp/tap/consul-template
  hashicorp/tap/levant
  hashicorp/tap/nomad
  hashicorp/tap/packer
  hashicorp/tap/terraform
  hashicorp/tap/terraform-ls
  hashicorp/tap/vault
  hashicorp/tap/waypoint
Some of these can be resolved with:
  brew untap aws/tap

Warning: You have an unnecessary local Cask tap.
This can cause problems installing up-to-date casks.
Please remove it by running:
  brew untap homebrew/cask

Warning: You have an unnecessary local Core tap!
This can cause problems installing up-to-date formulae.
Please remove it by running:
 brew untap homebrew/core

Description of issue

Homebrew PR 58826 is about a failing test caused by a change in upstream source for gitui. The gitui project wants to be a good community member so it created an issue of its own about testing the brew before releasing. I'm trying to tackle that but cannot think of a way to run the gitui formula test using unreleased source code. I have not worked with homebrew before.

Is there a maintainable way of doing this? Patching a clone of homebrew-core seems like a bad idea to me.

The output of brew config and brew doctor came from running gitui ci.yml at github.

[gromgit]

If by "unreleased source code" you mean "straight from a local source tree", then that's not possible with Homebrew.

If you mean "HEAD commit", then submit a PR to add a head block to the core formula, then anyone (including CI) can:

brew install --head --source gitui
brew test gitui

If you mean "a GitHub prerelease" (Homebrew's CI generally doesn't touch these), then:

brew bump-formula-pr --version <new_version> --write-only gitui
brew install --source gitui
brew test gitui

[peso]

I think the head block should be added to the core gitui formula. I will make a PR.

[p-linnane]

I've opened Homebrew/homebrew-core#216879 to add this.