summaryrefslogtreecommitdiff
path: root/plugins/brew
diff options
context:
space:
mode:
Diffstat (limited to 'plugins/brew')
-rw-r--r--plugins/brew/README.md21
-rw-r--r--plugins/brew/_brew108
-rw-r--r--plugins/brew/brew.plugin.zsh24
3 files changed, 44 insertions, 109 deletions
diff --git a/plugins/brew/README.md b/plugins/brew/README.md
new file mode 100644
index 000000000..c129a7652
--- /dev/null
+++ b/plugins/brew/README.md
@@ -0,0 +1,21 @@
+# brew plugin
+
+The plugin adds several aliases for common [brew](https://brew.sh) commands.
+
+To use it, add `brew` to the plugins array of your zshrc file:
+```
+plugins=(... brew)
+```
+
+## Aliases
+
+| Alias | Command | Description |
+|--------|----------------------|---------------|
+| brewp | `brew pin` | Pin a specified formulae, preventing them from being upgraded when issuing the brew upgrade <formulae> command. |
+| brews | `brew list -1` | List installed formulae, one entry per line, or the installed files for a given formulae. |
+| brewsp | `brew list --pinned` | Show the versions of pinned formulae, or only the specified (pinned) formulae if formulae are given. |
+| bubo | `brew update && brew outdated` | Fetch the newest version of Homebrew and all formulae, then list outdated formulae. |
+| bubc | `brew upgrade && brew cleanup` | Upgrade outdated, unpinned brews (with existing install options), then removes stale lock files and outdated downloads for formulae and casks, and removes old versions of installed formulae. |
+| bubu | `bubo && bubc` | Updates Homebrew, lists outdated formulae, upgrades oudated and unpinned formulae, and removes stale and outdated downloads and versions. |
+| bcubo | `brew update && brew cask outdated` | Fetch the newest version of Homebrew and all formulae, then list outdated casks. |
+| bcubc | `brew cask reinstall $(brew cask outdated) && brew cleanup` | Updates outdated casks, then runs cleanup. | \ No newline at end of file
diff --git a/plugins/brew/_brew b/plugins/brew/_brew
deleted file mode 100644
index d11aa245d..000000000
--- a/plugins/brew/_brew
+++ /dev/null
@@ -1,108 +0,0 @@
-#compdef brew
-#autoload
-
-# imported from the latest homebrew contributions
-
-_brew_all_formulae() {
- formulae=(`brew search`)
-}
-
-_brew_installed_formulae() {
- installed_formulae=(`brew list`)
-}
-
-_brew_installed_taps() {
- installed_taps=(`brew tap`)
-}
-
-_brew_outdated_formulae() {
- outdated_formulae=(`brew outdated`)
-}
-
-local -a _1st_arguments
-_1st_arguments=(
- 'audit:check formulae for Homebrew coding style'
- 'cat:display formula file for a formula'
- 'cleanup:uninstall unused and old versions of packages'
- 'commands:show a list of commands'
- 'create:create a new formula'
- 'deps:list dependencies of a formula'
- 'doctor:audits your installation for common issues'
- 'edit:edit a formula'
- 'fetch:download formula resources to the cache'
- 'gist-logs:generate a gist of the full build logs'
- 'home:visit the homepage of a formula or the brew project'
- 'info:information about a formula'
- 'install:install a formula'
- 'reinstall:install a formula anew; re-using its current options'
- 'link:link a formula'
- 'list:list files in a formula or not-installed formulae'
- 'log:git commit log for a formula'
- 'missing:check all installed formuale for missing dependencies.'
- 'outdated:list formulae for which a newer version is available'
- 'pin:pin specified formulae'
- 'postinstall:perform post_install for a given formula'
- 'prune:remove dead links'
- 'remove:remove a formula'
- 'search:search for a formula (/regex/ or string)'
- 'switch:switch linkage between installed versions of a formula'
- 'tap:tap a new formula repository from GitHub, or list existing taps'
- 'test-bot:test a formula and build a bottle'
- 'uninstall:uninstall a formula'
- 'unlink:unlink a formula'
- 'unpin:unpin specified formulae'
- 'untap:remove a tapped repository'
- 'update:pull latest repository'
- 'upgrade:upgrade outdated formulae'
- 'uses:show formulae which depend on a formula'
-)
-
-local expl
-local -a formulae installed_formulae installed_taps outdated_formulae
-
-_arguments \
- '(-v)-v[verbose]' \
- '(--cellar)--cellar[brew cellar]' \
- '(--config)--config[brew configuration]' \
- '(--env)--env[brew environment]' \
- '(--repository)--repository[brew repository]' \
- '(--version)--version[version information]' \
- '(--prefix)--prefix[where brew lives on this system]' \
- '(--cache)--cache[brew cache]' \
- '(--force)--force[brew force]' \
- '*:: :->subcmds' && return 0
-
-if (( CURRENT == 1 )); then
- _describe -t commands "brew subcommand" _1st_arguments
- return
-fi
-
-case "$words[1]" in
- install|reinstall|audit|home|homepage|log|info|abv|uses|cat|deps|edit|options)
- _brew_all_formulae
- _wanted formulae expl 'all formulae' compadd -a formulae ;;
- list|ls)
- _arguments \
- '(--unbrewed)--unbrewed[files in brew --prefix not controlled by brew]' \
- '(--pinned)--pinned[list all versions of pinned formulae]' \
- '(--versions)--versions[list all installed versions of a formula]' \
- '1: :->forms' && return 0
-
- if [[ "$state" == forms ]]; then
- _brew_installed_formulae
- _wanted installed_formulae expl 'installed formulae' compadd -a installed_formulae
- fi ;;
- remove|rm|uninstall|unlink|cleanup|link|ln|pin|unpin)
- _brew_installed_formulae
- _wanted installed_formulae expl 'installed formulae' compadd -a installed_formulae ;;
- search|-S)
- _arguments \
- '(--macports)--macports[search the macports repository]' \
- '(--fink)--fink[search the fink repository]' ;;
- untap)
- _brew_installed_taps
- _wanted installed_taps expl 'installed taps' compadd -a installed_tapsĀ ;;
- upgrade)
- _brew_outdated_formulae
- _wanted outdated_formulae expl 'outdated formulae' compadd -a outdated_formulae ;;
-esac
diff --git a/plugins/brew/brew.plugin.zsh b/plugins/brew/brew.plugin.zsh
index 42fb80c9a..cfbaa3480 100644
--- a/plugins/brew/brew.plugin.zsh
+++ b/plugins/brew/brew.plugin.zsh
@@ -1,2 +1,24 @@
+alias brewp='brew pin'
alias brews='brew list -1'
-alias bubu="brew update && brew upgrade && brew cleanup"
+alias brewsp='brew list --pinned'
+alias bubo='brew update && brew outdated'
+alias bubc='brew upgrade && brew cleanup'
+alias bubu='bubo && bubc'
+alias bcubo='brew update && brew cask outdated'
+alias bcubc='brew cask reinstall $(brew cask outdated) && brew cleanup'
+
+if command mkdir "$ZSH_CACHE_DIR/.brew-completion-message" 2>/dev/null; then
+ print -P '%F{yellow}'Oh My Zsh brew plugin:
+ cat <<-'EOF'
+
+ With the advent of their 1.0 release, Homebrew has decided to bundle
+ the zsh completion as part of the brew installation, so we no longer
+ ship it with the brew plugin; now it only has brew aliases.
+
+ If you find that brew completion no longer works, make sure you have
+ your Homebrew installation fully up to date.
+
+ You will only see this message once.
+ EOF
+ print -P '%f'
+fi