| name | formula-maintenance |
| description | Homebrew tap formula maintenance for xberg-io CLIs — source-build vs binary-only formula types, the version-bump checklist (url/version/sha256/bottles/root_url), and building bottles with scripts/build-bottles.sh. Load when editing a .rb formula, cutting a release bump, or updating bottle hashes. |
Formula Maintenance
Formula Types
Source-build (Rust/CMake, compile on install):
xberg.rb, alef.rb, crawlberg.rb — build from tarball via cargo install
Binary-only (pre-built platform-specific artifacts):
xberg-ffi.rb, libhtml-to-markdown.rb — install pre-compiled .dylib/.so/.a + headers
Version Bump Checklist
- Update
url and version fields
- Update
sha256 for source tarball or per-platform binary tarballs
- For bottles: run
scripts/build-bottles.sh, update bottle sha256 values from output
- Verify
root_url points to correct GitHub release tag
scripts/build-bottles.sh
- Canonical script for building bottles on current platform
- Runs
brew install --build-bottle then brew bottle
- Must be run on each target platform separately
- Output includes sha256 hashes to paste into formula's
bottle do block
