Bundler for non-Ruby dependencies from Homebrew
Homebrew or Linuxbrew are used for installing the dependencies. Linuxbrew is a fork of Homebrew for Linux, while Homebrew only works on Mac OS X. This tool is primarily developed for use with Homebrew on Mac OS X but should work with Linuxbrew on Linux, too.
brew tap is new feature in Homebrew 0.9, adds more GitHub repos to the list of available formulae.
Homebrew Cask is optional and used for installing Mac applications.
You can install as a Homebrew tap:
$ brew tap Homebrew/bundle
Brewfile in the root of your project:
$ touch Brewfile
Then list your Homebrew based dependencies in your
tap 'caskroom/cask' tap 'telemachus/brew', 'https://email@example.com/telemachus/brew.git' brew 'emacs', args: ['with-cocoa', 'with-gnutls'] brew 'redis', restart_service: true brew 'mongodb' brew 'sphinx' brew 'imagemagick' brew 'mysql' cask 'google-chrome' cask 'java' unless system '/usr/libexec/java_home --failfast'
You can then easily install all of the dependencies with one of the following commands:
$ brew bundle
If a dependency is already installed and there is an update available it will be upgraded.
You can create a
Brewfile from all the existing Homebrew packages you have installed with:
$ brew bundle dump
--force option will allow an existing
Brewfile to be overwritten as well.
You can also use
Brewfile as a whitelist. It's useful for maintainers/testers who regularly install lots of formulae. To uninstall all Homebrew formulae not listed in
$ brew bundle cleanup
--force option is passed, formulae will be listed rather than actually uninstalled.
You can check there's anything to install/upgrade in the
Brewfile by running:
$ brew bundle check
This provides a successful exit code if everything is up-to-date so is useful for scripting.
Homebrew does not support installing specific versions of a library, only the most recent one so there is no good mechanism for storing installed versions in a .lock file.
If your software needs specific versions then perhaps you'll want to look at using Vagrant to better match your development and production environments.
Over 10 different people have contributed to the project, you can see them all here: https://github.com/Homebrew/homebrew-bundle/graphs/contributors
Tests can be ran with
bundle && bundle exec rake spec
Note on Patches/Pull Requests
- Fork the project.
- Make your feature addition or bug fix.
- Add tests for it. This is important so I don't break it in a future version unintentionally.
- Add documentation if necessary.
- Commit, do not change Rakefile or history.
- Send a pull request. Bonus points for topic branches.
Copyright (c) 2015 Homebrew maintainers and Andrew Nesbitt. See LICENSE for details.