beefcarver/homebrew

A Homebrew tap for tools by beefcarver.

Important

This tap is not hosted on GitHub. It lives at tildeforge.dev/beefcarver/homebrew, so brew tap cannot guess its URL. You must pass the repository URL explicitly, and you must trust the tap before Homebrew will load its formulae.

Formulae

Formulae live under Formula/, sharded by the first letter of their name. See the directory for the currently available formulae.

Install

Because this tap is self-hosted, tapping is an explicit two-step procedure: add it by URL, then grant trust.

# 1. Tap by full URL — the one-argument form assumes github.com and fails here
brew tap beefcarver/homebrew https://tildeforge.dev/beefcarver/homebrew.git

# 2. Trust it (see "Trust" below for a narrower option)
brew trust beefcarver/homebrew

# 3. Install a formula from the tap
brew install <formula>

Building from HEAD instead of the latest release:

brew install --HEAD <formula>

Trust

A tap is a repository of Ruby: loading it runs code with your privileges, so non-official taps are untrusted by default since Homebrew 6.0.0. This tap is not an official Homebrew tap, and hosting it outside GitHub means there is no GitHub organisation vouching for it either — read the formula you intend to install before trusting anything.

Prefer trusting only what you need:

brew trust --formula beefcarver/homebrew/<formula>
brew install <formula>

Trusting the whole tap also trusts every formula ever added to it later:

brew trust beefcarver/homebrew

Inspect and revoke trust:

brew trust                            # list trusted taps and items
brew untrust                          # list untrusted taps and items
brew untrust beefcarver/homebrew      # revoke tap-wide trust

Do not disable the check with HOMEBREW_NO_REQUIRE_TAP_TRUST; it is deprecated and will be removed. See Homebrew's Tap Trust documentation.

Upgrading and removing

brew update
brew upgrade <formula>

brew uninstall <formula>
brew untap beefcarver/homebrew

Repository layout

Formula/
└── <first-letter>/
    └── <formula>.rb    # sharded by first letter, per Homebrew convention

Working on a formula

brew install --build-from-source ./Formula/<first-letter>/<formula>.rb   # local build
brew audit --strict --online <formula>                                   # lint
brew style <formula>                                                     # rubocop
brew test <formula>                                                      # run test block

If a formula builds a Python virtualenv, regenerate its resource blocks after changing the version or dependencies:

brew update-python-resources <formula>

Adding a new formula

Create Formula/<first-letter>/<name>.rb.
Fill in desc, homepage, url, and a real sha256 (brew fetch --build-from-source <url> prints the checksum).
brew audit --new --strict <name> to check it.
Commit, push, and tell users about the trust requirement.

License

Each formula is distributed under the license of the software it packages.

3.2 KiB Raw Blame History