summaryrefslogtreecommitdiff
path: root/lib/bundler/man/bundle-plugin.1.ronn
blob: b54e0c08b4e42476b45afbdeb7f4f424efbdb7ff (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
bundle-plugin(1) -- Manage Bundler plugins
==========================================

## SYNOPSIS

`bundle plugin` install PLUGINS [--source=SOURCE] [--version=VERSION]
                              [--git=GIT] [--branch=BRANCH|--ref=REF]
                              [--path=PATH]<br>
`bundle plugin` uninstall PLUGINS [--all]<br>
`bundle plugin` list<br>
`bundle plugin` help [COMMAND]

## DESCRIPTION

You can install, uninstall, and list plugin(s) with this command to extend functionalities of Bundler.

## SUB-COMMANDS

### install

Install the given plugin(s).

For example, `bundle plugin install bundler-graph` will install bundler-graph
gem from globally configured sources (defaults to RubyGems.org). Note that the
global source specified in Gemfile is ignored.

**OPTIONS**

* `--source=SOURCE`:
  Install the plugin gem from a specific source, rather than from globally configured sources.

  Example: `bundle plugin install bundler-graph --source https://example.com`

* `--version=VERSION`:
  Specify a version of the plugin gem to install via `--version`.

  Example: `bundle plugin install bundler-graph --version 0.2.1`

* `--git=GIT`:
  Install the plugin gem from a Git repository. You can use standard Git URLs like:

  `ssh://[user@]host.xz[:port]/path/to/repo.git`<br>
  `http[s]://host.xz[:port]/path/to/repo.git`<br>
  `/path/to/repo`<br>
  `file:///path/to/repo`

  Example: `bundle plugin install bundler-graph --git https://github.com/rubygems/bundler-graph`

* `--branch=BRANCH`:
  When you specify `--git`, you can use `--branch`  to use.

* `--ref=REF`:
  When you specify `--git`, you can use `--ref` to specify any tag, or commit
  hash (revision) to use.

* `--path=PATH`:
  Install the plugin gem from a local path.

  Example: `bundle plugin install bundler-graph --path ../bundler-graph`

### uninstall

Uninstall the plugin(s) specified in PLUGINS.

**OPTIONS**

* `--all`:
  Uninstall all the installed plugins. If no plugin is installed, then it does nothing.

### list

List the installed plugins and available commands.

No options.

### help

Describe subcommands or one specific subcommand.

No options.

## SEE ALSO

* [How to write a Bundler plugin](https://bundler.io/guides/bundler_plugins.html)