ohmyzsh/plugins/bundler/README.md

Bundler

• Adds completion for basic bundler commands

• Adds short aliases for common bundler commands

  • ba aliased to bundle add
  • be aliased to bundle exec. It also supports aliases (if rs is rails server, be rs will bundle-exec rails server).
  • bl aliased to bundle list
  • bp aliased to bundle package
  • bo aliased to bundle open
  • bout aliased to bundle outdated
  • bu aliased to bundle update
  • bi aliased to bundle install --jobs=<cpu core count> (only for bundler >= 1.4.0)
  • bcn aliased to bundle clean
  • bck aliased to bundle check

• Adds a wrapper for common gems:

  • Looks for a binstub under ./bin/ and executes it (if present)
  • Calls bundle exec <gem executable> otherwise

Common gems wrapped by default (by name of the executable): annotate, cap, capify, cucumber, foodcritic, guard, hanami, irb, jekyll, kitchen, knife, middleman, nanoc, pry, puma, rackup, rainbows, rake, rspec, rubocop, shotgun, sidekiq, spec, spork, spring, strainer, tailor, taps, thin, thor, unicorn and unicorn_rails.

Configuration

Please use the exact name of the executable and not the gem name.

Add additional gems to be wrapped

Add this before the plugin-list in your .zshrc:

BUNDLED_COMMANDS=(rubocop)
plugins=(... bundler ...)

This will add the wrapper for the rubocop gem (i.e. the executable).

Exclude gems from being wrapped

Add this before the plugin-list in your .zshrc:

UNBUNDLED_COMMANDS=(foreman spin)
plugins=(... bundler ...)

This will exclude the foreman and spin gems (i.e. their executable) from being wrapped.

Excluded gems

These gems should not be called with bundle exec. Please see issue #2923 on GitHub for clarification.

berks foreman mailcatcher rails ruby spin