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
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
|
<!DOCTYPE html>
<html>
<head>
<title>Bundler: The best way to manage a Ruby application's gems</title>
<meta content='text/html; charset=UTF-8' http-equiv='Content-Type'>
<meta content='276VSYOko8B8vIu1i8i5qbj7_ql5PXo0dU69XQy-SL' name='globalsign-domain-verification'>
<link href='/images/favicon.png' rel='shortcut icon' type='image/png'>
<link href="/stylesheets/application.css" media="screen" rel="stylesheet" type="text/css" />
<link href="/stylesheets/sunburst.css" media="screen" rel="stylesheet" type="text/css" />
</head>
<body>
<div id='body'>
<div id='contents'>
<div id='header'>
<a class="image" href="/"><img width="725" alt="The best way to manage your application's dependencies" src="/images/gembundler.png" />
</a>
</div>
<h2>Gems from git repositories</h2>
<div class='contents'>
<div class='bullet'>
<div class='description'>
Bundler adds the ability to use gems directly from git repositories. Setting
them up is as easy as adding a gem to your Gemfile. Using the very latest
version of a gem (or even a fork) is just as easy as using an official
release.
</div>
<div class='description'>
Because Rubygems lacks the ability to handle gems from git, any gems
installed from a git repository will not show up in <code>gem list</code>.
They will, however, be available after running <code>Bundler.setup</code>.
</div>
</div>
<div class='bullet'>
<div class='description'>
Specify that a gem should come from a git
repository with a .gemspec at its root
</div>
<pre class="sunburst">gem <span class="String"><span class="String">'</span>nokogiri<span class="String">'</span></span>, <span class="Constant"><span class="Constant">:</span>git</span> => <span class="String"><span class="String">'</span>git://github.com/tenderlove/nokogiri.git<span class="String">'</span></span>
</pre>
</div>
<div class='bullet'>
<div class='description'>
If there is no .gemspec at the root of
a git repository, you must specify a version
that bundler should use when resolving
dependencies
</div>
<pre class="sunburst">gem <span class="String"><span class="String">'</span>deep_merge<span class="String">'</span></span>, <span class="String"><span class="String">'</span>1.0<span class="String">'</span></span>, <span class="Constant"><span class="Constant">:</span>git</span> => <span class="String"><span class="String">'</span>git://github.com/peritor/deep_merge.git<span class="String">'</span></span>
</pre>
</div>
<div class='bullet'>
<div class='description'>
Specify that a git repository containing
multiple .gemspec files should be treated
as a gem source
</div>
<pre class="sunburst">git <span class="String"><span class="String">'</span>git://github.com/rails/rails.git<span class="String">'</span></span> <span class="Keyword">do</span>
 gem <span class="String"><span class="String">'</span>railties<span class="String">'</span></span>
 gem <span class="String"><span class="String">'</span>action_pack<span class="String">'</span></span>
 gem <span class="String"><span class="String">'</span>active_model<span class="String">'</span></span>
<span class="Keyword">end</span>
</pre>
</div>
<div class='bullet'>
<div class='description'>
Specify that a git repository should use
a particular ref, branch, or tag
</div>
<pre class="sunburst"><span class="Constant"><span class="Constant">:</span>git</span> => <span class="String"><span class="String">'</span>git://github.com/rails/rails.git<span class="String">'</span></span>, <span class="Constant"><span class="Constant">:</span>ref</span> => <span class="String"><span class="String">'</span>4aded<span class="String">'</span></span>
<span class="Constant"><span class="Constant">:</span>git</span> => <span class="String"><span class="String">'</span>git://github.com/rails/rails.git<span class="String">'</span></span>, <span class="Constant"><span class="Constant">:</span>branch</span> => <span class="String"><span class="String">'</span>2-3-stable<span class="String">'</span></span>
<span class="Constant"><span class="Constant">:</span>git</span> => <span class="String"><span class="String">'</span>git://github.com/rails/rails.git<span class="String">'</span></span>, <span class="Constant"><span class="Constant">:</span>tag</span> => <span class="String"><span class="String">'</span>v2.3.5<span class="String">'</span></span>
</pre>
</div>
<div class='bullet'>
<div class='description'>
Specifying a ref, branch, or tag for a
git repository specified inline works
exactly the same way
</div>
<pre class="sunburst">gem <span class="String"><span class="String">'</span>nokogiri<span class="String">'</span></span>, <span class="Constant"><span class="Constant">:</span>git</span> => <span class="String"><span class="String">'</span>git://github.com/tenderlove/nokogiri.git<span class="String">'</span></span>, <span class="Constant"><span class="Constant">:</span>ref</span> => <span class="String"><span class="String">'</span>0eec4<span class="String">'</span></span>
</pre>
</div>
<div class='bullet'>
<div class='description'>
If you are getting your gems from a public GitHub repository,
you can use the shorthand
</div>
<pre class="sunburst">gem <span class="String"><span class="String">'</span>nokogiri<span class="String">'</span></span>, <span class="Constant"><span class="Constant">:</span>github</span> => <span class="String"><span class="String">'</span>tenderlove/nokogiri<span class="String">'</span></span>
</pre>
<div class='description'>
If the repository name is the same as the GitHub account hosting it,
you can omit it
</div>
<pre class="sunburst">gem <span class="String"><span class="String">'</span>rails<span class="String">'</span></span>, <span class="Constant"><span class="Constant">:</span>github</span> => <span class="String"><span class="String">'</span>rails<span class="String">'</span></span>
</pre>
</div>
</div>
</div>
</div>
<div id='footer'>
<img src="/images/emocow.png" />
<img src="/images/panda.jpg" />
<div class='spacer'></div>
<div id='navigation'>
<p>
<b>commands</b>
<a href="/v1.1/man/bundle-install.1.html">install</a>
/
<a href="/v1.1/man/bundle-update.1.html">update</a>
/
<a href="/v1.1/man/bundle-exec.1.html">exec</a>
/
<a href="/v1.1/man/bundle-config.1.html">config</a>
/
<a href="/v1.1/man/bundle-package.1.html">package</a>
</p>
<p>
<b>usage</b>
<a href="/v1.1/gemfile.html">gemfile</a>
/
<a href="/v1.1/git.html">git</a>
/
<a href="/v1.1/groups.html">groups</a>
/
<a href="/v1.1/bundler_setup.html">setup</a>
/
<a href="/v1.1/deploying.html">deploying</a>
</p>
<p>
<b>frameworks</b>
<a href="/v1.1/bundler_setup.html">ruby</a>
/
<a href="/v1.1/rubygems.html">rubygems</a>
/
<a href="/v1.1/rubymotion.html">rubymotion</a>
/
<a href="/v1.1/sinatra.html">sinatra</a>
/
<a href="/v1.1/rails3.html">rails 3</a>
</p>
</div>
<div class='spacer'></div>
<img src="/images/bundler-small.png" />
</div>
<div id='credits'>
<p>
Many thanks to Bundler's <a href="/contributors.html">contributors</a>
and <a href="/sponsors.html">sponsors</a>
</p>
</div>
<a href='http://github.com/bundler/bundler/' id='github'>
<img alt='Fork me on GitHub' src='http://s3.amazonaws.com/github/ribbons/forkme_right_darkblue_121621.png'>
</a>
<div id='prod-versions'>
Docs:
<a href="/v0.9/">v0.9</a>
<a href="/v1.0/">v1.0</a>
<a class="current" href="/v1.1/">v1.1</a>
<a href="/v1.2/">v1.2</a>
<a href="/">v1.3</a>
</div>
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
ga('create', 'UA-39559982-1', 'bundler.io');
ga('send', 'pageview');
</script>
</body>
</html>
|
