2019-01-12 15:47:23 +00:00
# Bundler
2020-06-11 14:59:30 +00:00
- adds completion for basic bundler commands
- adds short aliases for common bundler commands
2019-10-24 19:09:05 +00:00
- `be` aliased to `bundle exec` .
2019-01-12 15:47:23 +00:00
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` )
2020-06-11 14:59:30 +00:00
- adds a wrapper for common gems:
- looks for a binstub under `./bin/` and executes it (if present)
- calls `bundle exec <gem executable>` otherwise
2019-01-12 15:47:23 +00:00
Common gems wrapped by default (by name of the executable):
2019-10-24 19:09:05 +00:00
`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` .
2019-01-12 15:47:23 +00:00
## 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` :
```sh
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` :
```sh
UNBUNDLED_COMMANDS=(foreman spin)
plugins=(... bundler ...)
```
This will exclude the `foreman` and `spin` gems (i.e. their executable) from being wrapped.
## Excluded gems
2019-11-22 19:01:23 +00:00
These gems should not be called with `bundle exec` . Please see [issue #2923 ](https://github.com/ohmyzsh/ohmyzsh/pull/2923 ) on GitHub for clarification.
2019-01-12 15:47:23 +00:00
`berks`
`foreman`
`mailcatcher`
`rails`
`ruby`
`spin`