https://github.com/drptbl/fb-homebrew-tap

a Homebrew tap for software maintained by Facebook
https://github.com/drptbl/fb-homebrew-tap

Last synced: about 1 month ago
JSON representation

a Homebrew tap for software maintained by Facebook

• Host: GitHub
• URL: https://github.com/drptbl/fb-homebrew-tap
• Owner: drptbl
• Created: 2015-09-13T17:32:59.000Z (almost 11 years ago)
• Default Branch: master
• Last Pushed: 2015-09-02T20:10:13.000Z (almost 11 years ago)
• Last Synced: 2025-11-21T14:42:08.318Z (7 months ago)
• Language: Ruby
• Size: 140 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
Facebook Homebrew Tap

=====================

This is a [Homebrew][brew] tap for formulae for software developed by Facebook.

Setup

-----

Using these formulae requires Homebrew, which in turn requires Xcode. If you

have not yet installed Homebrew, a quick summary is at the end of this

document.

Once homebrew is installed, simply run:

    brew tap facebook/fb-homebrew-tap https://github.com/facebook/fb-homebrew-tap

Some of these formulae may require OS X 10.10 (Yosemite) or higher.

Use

---

To install software, just use `brew install` with the name of the formula. You

may wish to run `brew update` before hand to get the latest version of the

formulae. For example, to install the latest version of the thrift compiler:

    brew update

    brew install fbthrift-compiler

To upgrade software:

    brew update

    brew upgrade    # upgrade all software installed with Homebrew

    brew upgrade fbthrift-compiler   # update just the thrift compiler

Contributing

------------

We use GitHub's [issue tracker][issue] for bug reports or feature requests.

To do development on these formulae, first fork the repository on GitHub. Add

your fork as a remote to your local clone:

    cd $(brew --prefix)/Library/Taps/facebook/homebrew-fb-homebrew-tap

    git remote add me git@github.com:YOUR_GITHUB_USERNAME/fb-homebrew-tap.git

    git fetch me

To propose changes, push to your fork (e.g. with `git push me +master`) and

submit pull request on GitHub.

If you do not work for Facebook, you will need to [submit a Contributor License

Agreement ("CLA")][cla]. You only need to do this once to work on any of

Facebook's open source projects.

We follow Homebrew's [standard coding style][style].

Appendix: overview of installing Homebrew

-----------------------------------------

The Homebrew developers suggest installing Homebrew at `/usr/local` to maximize

compatibility with existing software. To do so, follow the instructions on

[their website][brew].

This author prefers `/opt/homebrew`, finding that it works well enough in

practice and keeps a cleaner separation between other software which might use

`/usr/local`. To install at `/opt/homebrew`, you can use:

    sudo mkdir /opt/homebrew

    sudo chown `whoami` /opt/homebrew

    curl -sSLf -o homebrew-installer https://raw.githubusercontent.com/Homebrew/install/master/install

    perl -pi -e s,/usr/local,/opt/homebrew, homebrew-installer

    ruby homebrew-installer

    rm homebrew-installer

    echo '$PATH="/opt/homebrew/bin:/opt/homebrew/sbin:$PATH"' >> ~/.bashrc

References

----------

`brew help`, `man brew`, or the Homebrew [documentation][].

[brew]: http://brew.sh/

[issue]: https://github.com/facebook/fb-homebrew-tap/issues

[cla]: https://code.facebook.com/cla

[style]: https://github.com/Homebrew/homebrew/blob/master/share/doc/homebrew/Formula-Cookbook.md

[documentation]: https://github.com/Homebrew/homebrew/tree/master/share/doc/homebrew#readme