homebrew and linuxbrew formula Notes

Contents

• General homebrew usage
• Homebrew Cask
  • Homebrew Cask Installation
• Working with Python 2.x / 3.x
  • Python Useful Links
• Build time options / parameters
• Useful Links
• TODOs

General homebrew brew & cask usage

To remove soure tarballs and downloaded .DMGs for homebrew and cask

```fish
brew cleanup
brew cask cleanup
```

...will remove downloaded tarballs and image files stored within the below directory

```fish
$HOME/Library/Caches/Homebrew
```

To show outdated formula for homebrew

```fish
brew outdated
brew cask outdated
```

> A lot of formula installed with `cask` update themeselves, but can also be updated with the `--greedy` flag.

```fish
brew cask upgrade --greedy
```

To print a list of sources tapped for homebrew usage

```fish
brew tap
```

To print a pretty 💋 list of installed Homebrew formula and their dependencies in a graphical format

```fish
brew deps --tree --installed
```

[More information](https://docs.brew.sh/Taps) for working with taps

## Generating a list of installed packages, ie. formula and casks

```fish
brew bundle
```

To overwrite an existing `Brewfile`

```fish
brew bundle --force dump
```

<a href="homebrew-cask"></a>

## homebrew cask

> ⚠️ [Homebrew cask](https://caskroom.github.io/) is not the SAME thing as [emacs cask](https://cask.readthedocs.io/en/latest/index.html)

<a href="homebrew-cask-installation"></a>

### Homebrew-Cask _Installation_

To install Homebrew-Cask via [Homebrew](http://brew.sh)

```fish
brew tap caskroom/cask
```

### [Homebrew-Cask Versions](https://github.com/caskroom/homebrew-versions) _Installation_

To install the above mentioned repo

```fish
brew tap caskroom/versions
```

To install a cask from caskroom/versions/hyper-canary

```fish
brew cask install hyper-canary
```

<a href="working-with-python-2-3"></a>

## Working with Pythons - 2.x 3.x

### Initial Setup

> After installing python via homebrew and is properly configured in the `PATH`

```fish
python -m pip install --upgrade setuptools
```

```fish
python -m pip install --upgrade pip
```

> ⚠️   When using the `--user` flag with `pip` on macOS packages, ie. `virtualenv` will be placed in `$HOME/Library/Python/[major.minor]/bin/




Homebrew can install concurrent Pythons on the local system.

Homebrew seperates the pythons by creating seperate binaries, ie.
python 2.x is located at

```fish
/usr/local/opt/python/libexec/bin/python
```
and python 3.x is located at

```fish
/usr/local/bin/python3
```

Both pythons use a seperate `pip` package to manage python dependencies, ie. python 2.x uses

```fish
/usr/local/opt/python/libexec/bin/pip
```

and python 3.x uses

```fish
/usr/local/bin/pip3
```


<a href="python-useful-links"></a>

### Python Useful Links
[Homebrew documentation - Python](https://docs.brew.sh/Homebrew-and-Python.html)

<a href="build-time-options"></a>

## Build time options / parameters

To show build time options for a homebrew formula

```fish
brew info [mr_fancy_pants_formula]
```

> brew info weechat

<a href="working-with-homebrew-casks"></a>

## Working with homebrew casks

To search for a brew formula from a cask, ie. `kodi`

```fish
brew search kodi
```

Output:

```fish
brew search kodi                                                                    0 < 14:24:28
==> Searching local taps...
==> Searching taps on GitHub...
caskroom/cask/kodi                                 caskroom/versions/kodi-development
==> Searching blacklisted, migrated and deleted formulae...
```

Then to install kodi

```fish
brew cask install kodi
```

---

Homebrew 🍻 formula are stored in the following location on macOS (10.12.6)

```shell
/usr/local/Homebrew/Library/Taps/homebrew/homebrew-core/Formula/
```
However, linuxbrew formula are more than likely located at the below path on Debian Jessie

```shell
/home/linuxbrew/.linuxbrew/Homebrew/Library/Taps/homebrew/homebrew-core/Formula/
```

To edit a formula, make sure the `$EDITOR` environment variable is set to your favorite text editor, ie. in the fish shell,

```shell
set -x EDITOR /path/to/your/favorite/editor
```
Example

```shell
set -x EDITOR /home/linuxbrew/.linuxbrew/bin/nvim
```

Then one can edit the formula of choosing with the below command,

```shell
brew edit <name_of_formula.rb>
```
Example

```shell
brew edit weechat.rb
```

To list all installed packages with homebrew 🍻

```fish
brew list
brew cask list
```
To get the SHA 256 hash of a file

```fish
shasum -a 256 <name_of_file> | awk '{printf $1}' | pbcopy
```

<a href="useful-links"></a>

## Useful Links 🔗
- [Official - search for formula](http://formulae.brew.sh/)
- [How to Create and Maintain a Tap](https://github.com/Homebrew/brew/blob/master/docs/How-to-Create-and-Maintain-a-Tap.md)<br />
- [Formula Cookbook for developers](https://github.com/Homebrew/brew/blob/master/docs/Formula-Cookbook.md)<br />
- [Python for Formula Authors](https://github.com/Homebrew/brew/blob/master/docs/Python-for-Formula-Authors.md)<br />
- [A deep dive 🏊 into homebrew dependencies](http://blog.jpalardy.com/posts/untangling-your-homebrew-dependencies/)

<a href="todos"></a>

## TODOs

- [x] add entries to table of contents for this .md file
- [ ] figure out which binaries belong to which packages, ie. which package installed `locate`