Skip to content

brew: add Homebrew formula for macOS - #298

Open
idlethread wants to merge 2 commits into
linux-msm:masterfrom
idlethread:brew-macos-support
Open

brew: add Homebrew formula for macOS#298
idlethread wants to merge 2 commits into
linux-msm:masterfrom
idlethread:brew-macos-support

Conversation

@idlethread

Copy link
Copy Markdown
Contributor

Summary

  • Add a Homebrew formula (Formula/qdl.rb) so macOS users can install qdl
    via brew tap linux-msm/qdl https://github.com/linux-msm/qdl followed
    by brew install --HEAD linux-msm/qdl/qdl.
  • The formula supports both --HEAD (Meson) and the stable v2.6 release
    (GNU Make), since the build system migrated to Meson after v2.6.
  • Add a CI workflow (.github/workflows/brew.yml) that, on each version
    tag push, downloads the release tarball, computes its SHA256, and
    updates Formula/qdl.rb automatically so the in-tree formula stays in
    sync with releases without manual intervention.

Test plan

  • meson setup build && meson compile -C build succeeds on macOS
    (Homebrew libusb, libxml2, libzip, meson, ninja, help2man)
  • meson compile manpages -C build && meson install -C build --destdir ...
    installs qdl and qdl.1 as the formula's HEAD install block expects
  • Verified the v2.6 tarball SHA256 in the formula matches the actual
    GitHub release archive
  • meson compile check-range -C build (checkpatch) passes clean on
    both commits
  • Commit messages pass commitlint (subsystem-prefixed subject,
    rationale body, Signed-off-by trailer)

@idlethread
idlethread requested a review from a team as a code owner July 27, 2026 17:12
Add a Homebrew formula for qdl. Users can install the latest release or
the development HEAD by tapping the repository:

  brew tap linux-msm/qdl https://github.com/linux-msm/qdl
  brew install linux-msm/qdl/qdl        # latest tagged release
  brew install --HEAD linux-msm/qdl/qdl # tip of master

Every release since the build system migrated to Meson (v2.7, v2.7.1)
builds cleanly with it, so the formula uses the same Meson-based
install steps for both the stable url (pinned to v2.7.1) and HEAD.

Document the tap-and-install flow in README.md, along with tapping a
local checkout to build and test formula changes before they land.

Signed-off-by: Amit Kucheria <amit.kucheria@oss.qualcomm.com>
When a version tag (vX.Y) is pushed, the workflow downloads the
corresponding release tarball, computes its SHA256 digest and updates
Formula/qdl.rb with the new URL and hash, then commits the result back
to master.

This keeps the in-tree formula in sync with each release without any
manual intervention.

Signed-off-by: Amit Kucheria <amit.kucheria@oss.qualcomm.com>
@idlethread
idlethread force-pushed the brew-macos-support branch from a377b26 to 04d0e79 Compare July 27, 2026 17:47

@igoropaniuk igoropaniuk left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Although I like the idea of adding a Homebrew formula for QDL, I’m against direct bot pushes to master and keeping the formula file inside the repostiory,

IMO a separate linux-msm/homebrew-qdl tap repo is the conventional route, and it would dissolve most of the workflow problems. User could just run brew tap linux-msm/qdl in this case and brew will auto-resolve homebrew-qdl rep + no bot commits to qdl's master are needed + brew update will pull only formula-containing repo instead the whole QDL repo.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants