Homebrew tap for Comcast's open source software.
To install this tap:
brew tap comcast/opensource https://github.com/Comcast/homebrew-opensource.git
You should then see output like this:
==> Tapping comcast/opensource
Cloning into '/usr/local/Homebrew/Library/Taps/comcast/homebrew-opensource'...
remote: Counting objects: 9, done.
remote: Compressing objects: 100% (8/8), done.
remote: Total 9 (delta 0), reused 8 (delta 0), pack-reused 0
Receiving objects: 100% (9/9), 6.60 KiB | 6.60 MiB/s, done.
Tapped 3 formulae (30 files, 43.4KB)
From there, packages such as Snowdrift can be installed:
==> Installing snowdrift from comcast/opensource
==> Downloading https://github.com/Comcast/snowdrift/archive/snowdrift-1.0.1.tar.gz
==> Downloading from https://codeload.github.com/Comcast/snowdrift/tar.gz/snowdrift-1.0.1
######################################################################## 100.0%
🍺 /usr/local/Cellar/snowdrift/1.0.1: 7 files, 33.7KB, built in 1 second
- Snowdrift - Painless firewall testing
- Use case: Use before submitting a firewall ticket, then run tests when ticket is complete to verify connectivity
- Ssh-to - Easily manage hundreds of servers
- Use case: Daily one-offs of connecting to servers you manage
- Compare-ini-files - Programatically compare an arbitrary number of .ini files
- Use case: versions of a server deployed in different datacenters with slightly different configuration files that you'd like to merge
These example commands will be for the snowdrift package.
- Tag the current HEAD
git tag snowdrift-1.0.1 -agit tag -l# View the current tagsgit push --tags
- Add our tap
- Note that the repo MUST start with
homebrew- brew tap comcast/opensource git@github.com:Comcast/homebrew-opensource.git- This syntax is slightly different, since Comcast is an organization name, not a GitHub username.
- Note that the repo MUST start with
- Create a new forumla based on the release (tarball) that corresponds to the tag created above
- To get the path to the tarball, go to your app's repo, click "releases", click on "tags", then right click on the
tar.gzlink to get that tarball's URL brew create https://github.com/Comcast/snowdrift/archive/snowdrift-1.0.tar.gz --tap comcast/opensource
- To get the path to the tarball, go to your app's repo, click "releases", click on "tags", then right click on the
- Now, go into our tap's directory:
cd $(brew --repo comcast/opensource)
- Verify that the formula is in the
Formula/directory - Test installing that formula
brew install -verbose snowdrift- HINT: If you're installing a script of some kind, you'll want to make use of
bin.install "snowdrift"in the install method.
- Verify that
snowdriftexecutable is presentwhich snowdrift
- Audit/test the formula
brew audit snowdrift
- Now commit this repo and push, optionally by creating a branch and a PR
These examples will again be for the snowdrift package.
In your project:
- Go into the "Releases" tab in GitHub and create a new release. Note the URL of the
tar.gzfile in the release.
In this repo:
- Go into the tap's directory
cd $(brew --repo comcast/opensource)
- Add a new release tarball
brew edit snowdrift- Remember the path of the
tar.gzfile? Update theurlfield in the formula with it.
- Download the new release:
brew fetch snowdrift --build-from-source
- Update the SHA256
- Note the SHA256 displayed when fetching the file,
editthe formula, and change it to the new value
- Note the SHA256 displayed when fetching the file,
- Save Formula file, commit and push to GitHub
Douglas Muth douglas_muth@cable.comcast.com
Bugs can be filed here or emailed directly to me.