build(packaging): add Homebrew tap formula and release sync
Build-from-source formula for macOS/Linuxbrew, mirroring the Arch PKGBUILD. A Gitea workflow recomputes the tarball checksum on each version tag and syncs the formula into the homebrew-yellowjacket tap repo, so releases need no manual formula edits. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Claude Opus 4.8
@@ -0,0 +1,65 @@
|
||||
# typed: false
|
||||
# frozen_string_literal: true
|
||||
|
||||
# YellowJacket — cross-platform desktop music player built with Wails (Go + Lit).
|
||||
#
|
||||
# This formula builds from source. The Wails toolchain (`go tool wails`) resolves
|
||||
# from the tool directives in go.mod, and Wails drives the frontend install/build
|
||||
# itself (pnpm), so only the Go toolchain, Node, and pnpm are needed at build time.
|
||||
#
|
||||
# This file is the canonical source. On each tagged release, CI computes the
|
||||
# tarball checksum and syncs an updated copy into the homebrew-yellowjacket tap
|
||||
# repo (see .gitea/workflows/homebrew-formula.yml). The `version`/`sha256` lines
|
||||
# below are what CI rewrites — keep them on their own lines.
|
||||
class Yellowjacket < Formula
|
||||
desc "Cross-platform desktop music player — local library, MusicBrainz explore & auto-tag"
|
||||
homepage "https://git.ljones.me/yonlu/yellowjacket"
|
||||
version "1.3.0"
|
||||
url "https://git.ljones.me/yonlu/yellowjacket/archive/v#{version}.tar.gz"
|
||||
sha256 "11929d9a7a32839f86213502b698a02376b38f0838fa20610408f062423899e5"
|
||||
license :cannot_represent # custom license — see repository
|
||||
|
||||
head "https://git.ljones.me/yonlu/yellowjacket.git", branch: "main"
|
||||
|
||||
depends_on "go" => :build
|
||||
depends_on "node" => :build
|
||||
depends_on "pnpm" => :build
|
||||
|
||||
# Wails targets macOS and Linux. On Linux, Homebrew builds against the system
|
||||
# WebKitGTK/GTK stack, which must be present (webkit2gtk-4.1, gtk3, alsa-lib).
|
||||
on_linux do
|
||||
depends_on "pkg-config" => :build
|
||||
end
|
||||
|
||||
def install
|
||||
ENV["CGO_ENABLED"] = "1"
|
||||
# Keep Go resolving modules from the network into its sandboxed cache.
|
||||
ENV["GOFLAGS"] = "-mod=mod"
|
||||
|
||||
commit = build.head? ? "HEAD" : "v#{version}"
|
||||
ldflags = "-s -w -X 'main.version=v#{version}' -X 'main.commit=#{commit}'"
|
||||
|
||||
system "go", "generate", "./..."
|
||||
system "go", "tool", "wails", "build",
|
||||
"-tags", "webkit2_41",
|
||||
"-clean", "-trimpath",
|
||||
"-ldflags", ldflags
|
||||
|
||||
# Wails emits a .app bundle on macOS and a bare ELF binary on Linux.
|
||||
if OS.mac?
|
||||
prefix.install "build/bin/YellowJacket.app"
|
||||
bin.write_exec_script "#{prefix}/YellowJacket.app/Contents/MacOS/YellowJacket"
|
||||
else
|
||||
bin.install "build/bin/yellowjacket"
|
||||
end
|
||||
end
|
||||
|
||||
test do
|
||||
# The GUI binary has no headless mode; assert it was built and is runnable.
|
||||
if OS.mac?
|
||||
assert_predicate prefix/"YellowJacket.app/Contents/MacOS/YellowJacket", :executable?
|
||||
else
|
||||
assert_predicate bin/"yellowjacket", :executable?
|
||||
end
|
||||
end
|
||||
end
|
||||
@@ -0,0 +1,76 @@
|
||||
# YellowJacket Homebrew formula
|
||||
|
||||
The formula builds YellowJacket from source on macOS and Linuxbrew, mirroring
|
||||
the Arch `PKGBUILD`: the Wails toolchain resolves from `go.mod`'s tool
|
||||
directives and drives the frontend build itself, so the only build inputs are
|
||||
Go, Node, and pnpm.
|
||||
|
||||
```
|
||||
packaging/homebrew/
|
||||
└── Formula/
|
||||
└── yellowjacket.rb ← canonical source; CI syncs it to the tap repo
|
||||
```
|
||||
|
||||
## Installing
|
||||
|
||||
```bash
|
||||
brew install shadow-puppet/yellowjacket/yellowjacket
|
||||
```
|
||||
|
||||
`shadow-puppet/yellowjacket` is Homebrew shorthand for the tap repo
|
||||
`github.com/Shadow-Puppet/homebrew-yellowjacket`. Brew auto-taps it, so there's
|
||||
no separate `brew tap` step. To build the tip of `main` instead of the latest
|
||||
release, add `--HEAD`.
|
||||
|
||||
## How publishing works
|
||||
|
||||
This directory holds the **canonical** formula. The tap users install from lives
|
||||
in a **separate** repo — `homebrew-yellowjacket` — because Homebrew only
|
||||
discovers formulae from a repo whose name starts with `homebrew-`, with the
|
||||
formula at a top-level `Formula/`. Keeping it separate is also why nothing has
|
||||
to live in this repo's root.
|
||||
|
||||
On every version tag (`v*`), `.gitea/workflows/homebrew-formula.yml`:
|
||||
|
||||
1. downloads the GitHub release tarball for that tag,
|
||||
2. computes its `sha256`,
|
||||
3. rewrites the `version` and `sha256` lines in the formula, and
|
||||
4. commits the result to `homebrew-yellowjacket`'s `Formula/yellowjacket.rb`.
|
||||
|
||||
So a normal release needs **no manual formula edits** — tag, and the tap updates
|
||||
itself. (This is the Homebrew equivalent of the Arch package's publish workflow.)
|
||||
|
||||
### About the `sha256`
|
||||
|
||||
Homebrew re-downloads the source tarball on each install and refuses to build
|
||||
unless its checksum matches `sha256` — integrity/tamper detection. The committed
|
||||
value here is a `REPLACE_WITH_...` placeholder on purpose; the real checksum is
|
||||
computed and injected by CI at release time, so it never has to be maintained by
|
||||
hand. (The Arch `PKGBUILD` sidesteps this with `SKIP` because it clones over git
|
||||
rather than downloading a tarball.)
|
||||
|
||||
## One-time setup
|
||||
|
||||
1. **Create the tap repo:** `Shadow-Puppet/homebrew-yellowjacket` on GitHub,
|
||||
with a `main` branch. It can start empty — the first tagged release seeds
|
||||
`Formula/yellowjacket.rb`.
|
||||
2. **Add a CI secret:** `HOMEBREW_TAP_TOKEN` — a GitHub token with write access
|
||||
to that repo (a fine-grained PAT scoped to `homebrew-yellowjacket`, Contents:
|
||||
read/write, is enough).
|
||||
|
||||
That's it. The source repo must be public (or the tap private with an
|
||||
authenticated `brew install`) for brew to fetch the release tarball.
|
||||
|
||||
## Notes
|
||||
|
||||
- **License**: declared as `license :cannot_represent` (custom license). Replace
|
||||
with the correct SPDX identifier once the license is finalized.
|
||||
- **macOS vs Linux**: `wails build` produces a `YellowJacket.app` bundle on
|
||||
macOS (installed under the Cellar with an `exec` shim in `bin`) and a bare
|
||||
`yellowjacket` binary on Linux (installed to `bin`).
|
||||
- **Linuxbrew**: building on Linux additionally needs the system WebKitGTK/GTK
|
||||
stack (`webkit2gtk-4.1`, `gtk3`, `alsa-lib`) — OS packages, not Homebrew deps.
|
||||
macOS needs only the Xcode Command Line Tools.
|
||||
- **Cask alternative**: if you later ship prebuilt macOS `.dmg`/`.zip` artifacts,
|
||||
a Homebrew *cask* pointing at those installs faster than this source build.
|
||||
This formula is the source-build path.
|
||||
Reference in New Issue
Block a user