Homebrew

TL;DR
Downgrade an application to a non-managed version
1. The easy way
2. The hard way
Download packages preemptively
Gotchas
Further readings
Sources

TL;DR

Installation

# Install.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Uninstall.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"

Configuration

# Require SHA check for casks.
# Change cask installation dir to the Application folder in the user's HOME.
export HOMEBREW_CASK_OPTS="--require-sha --appdir $HOME/Applications"

# Print install times for each formula at the end of the run.
export HOMEBREW_DISPLAY_INSTALL_TIMES=1

# Do not automatically update before running some commands.
export HOMEBREW_NO_AUTO_UPDATE=1

# Do not print HOMEBREW_INSTALL_BADGE on a successful build.
export HOMEBREW_NO_EMOJI=1

# Do not use the GitHub API.
# Avoid searches or fetching relevant issues after a failed install.
export HOMEBREW_NO_GITHUB_API=1

# Forbid redirects from secure HTTPS to insecure HTTP.
export HOMEBREW_NO_INSECURE_REDIRECT=1

# Only list updates to installed software.
export HOMEBREW_UPDATE_REPORT_ONLY_INSTALLED=1

# Pass the -A option when calling sudo.
export SUDO_ASKPASS=1

Usage

# Search for formulae.
brew search 'parallel'
brew search --cask 'gpg'

# Install something.
brew install 'gettext'
brew install --cask 'spotify'

# Start managing manually-installed apps
brew install --cask --adopt 'textmate'

# Get formulae's dependencies.
brew deps
brew deps --installed 'azure-cli'
brew deps --tree

# Get information on formulae.
brew info 'sponge'

# List all files installed by formulae.
brew ls -v 'coreutils'
brew ls -v --cask 'firefox'

# Prevent formulae from upgrading.
brew pin 'gnupg2'

# Uninstall something.
brew uninstall --zap 'keybase'

# (Re)create links for applications.
brew link 'kubernetes-cli'

# Show outdated casks.
brew outdated --cask --greedy

# Add taps.
# Only one at a time.
brew tap 'homebrew/services'

# Manage services.
# Requires the 'homebrew/services' tap.
brew services start 'openssl-osx-ca'

# Bring an installation up to speed from a Brewfile.
brew bundle
brew bundle --global
brew bundle install --file "$HOME/Brewfile"

# Check what changes from a Brewfile.
brew bundle check
brew bundle … check --file "$HOME/Brewfile"

# Check what items not listed in a Brewfile would be removed.
brew bundle cleanup
brew bundle … cleanup --file "$HOME/Brewfile"

# Remove items not listed in a Brewfile.
brew bundle … --cleanup --zap

# Dump all installed casks/formulae/images/taps into a Brewfile.
brew bundle dump

Downgrade an application to a non-managed version

The easy way

brew unlink kubernetes-helm
brew install https://raw.githubusercontent.com/Homebrew/homebrew-core/ed9dcb2cb455a816f744c3ad4ab5c18a0d335763/Formula/kubernetes-helm.rb
brew switch kubernetes-helm 2.13.0

The hard way

source alternative source

formula_name='kubernetes-helm'
formula_version='2.13.1'

cd $(brew --repository)/Library/Tapshomebrew/homebrew-core
git log master -S${formula_version} -- Formula/${formula_name}.rb
commit_id='<something>'  # insert commit id

git checkout -b ${formula_name}-${formula_version} ${commit_id}
HOMEBREW_NO_AUTO_UPDATE=1 brew install ${formula_name}
# pin application if needed

git checkout master
git branch -d ${formula_name}-${formula_version}

Download packages preemptively

Sometimes the file will continuously fail to download for some reason (like a badly configured antivirus software that keeps cutting out your download).

You can download the installation file yourself in steps and try the installation again:

$ brew install --cask 'docker'
…
==> Downloading https://desktop.docker.com/mac/main/amd64/131620/Docker.dmg
######################################################   36.6%curl: (18) Transferred a partial file

$ brew --cache 'homebrew/cask/docker'
/Users/username/Library/Caches/Homebrew/downloads/508b…95f1--Docker.dmg

$ curl -L -C - -o "$(brew --cache 'homebrew/cask/docker')" \
    'https://desktop.docker.com/mac/main/amd64/131620/Docker.dmg'
** Resuming transfer from byte position 1282048
…
curl: (18) Transferred a partial file

$ curl -L -C - -o "$(brew --cache 'homebrew/cask/docker')" \
    'https://desktop.docker.com/mac/main/amd64/131620/Docker.dmg'
** Resuming transfer from byte position 242762028
…

$ brew install --cask 'docker'
…
==> Downloading https://desktop.docker.com/mac/main/amd64/131620/Docker.dmg
Already downloaded: /Users/username/Library/Caches/Homebrew/downloads/508b…95f1--Docker.dmg
==> Installing Cask docker
…
docker was successfully installed!

Gotchas

moreutils installs its own old version of parallel, which conflicts with the parallel formulae.
Install the standalone gettext, parallel and sponge to have a recent version of theirs.

6.4 KiB Raw Blame History