This commit is contained in:
@@ -0,0 +1,92 @@
|
||||
bundle-add(1) -- Add gem to the Gemfile and run bundle install
|
||||
==============================================================
|
||||
|
||||
## SYNOPSIS
|
||||
|
||||
`bundle add` <GEM_NAME> [--group=GROUP] [--version=VERSION] [--source=SOURCE]
|
||||
[--path=PATH] [--git=GIT|--github=GITHUB] [--branch=BRANCH] [--ref=REF]
|
||||
[--cooldown=NUMBER] [--quiet] [--skip-install] [--strict|--optimistic]
|
||||
|
||||
## DESCRIPTION
|
||||
|
||||
Adds the named gem to the [`Gemfile(5)`][Gemfile(5)] and run `bundle install`.
|
||||
`bundle install` can be avoided by using the flag `--skip-install`.
|
||||
|
||||
## OPTIONS
|
||||
|
||||
* `--version=VERSION`, `-v=VERSION`:
|
||||
Specify version requirements(s) for the added gem.
|
||||
|
||||
* `--group=GROUP`, `-g=GROUP`:
|
||||
Specify the group(s) for the added gem. Multiple groups should be separated by commas.
|
||||
|
||||
* `--source=SOURCE`, `-s=SOURCE`:
|
||||
Specify the source for the added gem.
|
||||
|
||||
* `--require=REQUIRE`, `-r=REQUIRE`:
|
||||
Adds require path to gem. Provide false, or a path as a string.
|
||||
|
||||
* `--path=PATH`:
|
||||
Specify the file system path for the added gem.
|
||||
|
||||
* `--git=GIT`:
|
||||
Specify the git source for the added gem.
|
||||
|
||||
* `--github=GITHUB`:
|
||||
Specify the github source for the added gem.
|
||||
|
||||
* `--branch=BRANCH`:
|
||||
Specify the git branch for the added gem.
|
||||
|
||||
* `--ref=REF`:
|
||||
Specify the git ref for the added gem.
|
||||
|
||||
* `--glob=GLOB`:
|
||||
Specify the location of a dependency's .gemspec, expanded within Ruby (single quotes recommended).
|
||||
|
||||
* `--quiet`:
|
||||
Do not print progress information to the standard output.
|
||||
|
||||
* `--skip-install`:
|
||||
Adds the gem to the Gemfile but does not install it.
|
||||
|
||||
* `--optimistic`:
|
||||
Adds optimistic declaration of version.
|
||||
|
||||
* `--strict`:
|
||||
Adds strict declaration of version.
|
||||
|
||||
* `--cooldown=<number>`:
|
||||
Only consider gem versions published at least <number> days ago when
|
||||
resolving. Pass `0` to disable cooldown for this run. See `cooldown`
|
||||
in bundle-config(1) for precedence rules.
|
||||
|
||||
## EXAMPLES
|
||||
|
||||
1. You can add the `rails` gem to the Gemfile without any version restriction.
|
||||
The source of the gem will be the global source.
|
||||
|
||||
`bundle add rails`
|
||||
|
||||
2. You can add the `rails` gem with version greater than 1.1 (not including 1.1) and less than 3.0.
|
||||
|
||||
`bundle add rails --version "> 1.1, < 3.0"`
|
||||
|
||||
3. You can use the `https://gems.example.com` custom source and assign the gem
|
||||
to a group.
|
||||
|
||||
`bundle add rails --version "~> 5.0.0" --source "https://gems.example.com" --group "development"`
|
||||
|
||||
4. The following adds the `gem` entry to the Gemfile without installing the
|
||||
gem. You can install gems later via `bundle install`.
|
||||
|
||||
`bundle add rails --skip-install`
|
||||
|
||||
5. You can assign the gem to more than one group.
|
||||
|
||||
`bundle add rails --group "development, test"`
|
||||
|
||||
## SEE ALSO
|
||||
|
||||
[Gemfile(5)](https://guides.rubygems.org/gemfile/),
|
||||
[bundle-remove(1)](bundle-remove.1.html)
|
||||
Reference in New Issue
Block a user