forked from rubygems/bundler
/
git.html
139 lines (139 loc) · 8.18 KB
/
git.html
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
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<title>Bundler: The best way to manage Ruby applications</title>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<link href="/stylesheets/application.css" media="all" rel="stylesheet" type="text/css"/><link href="/stylesheets/sunburst.css" media="all" rel="stylesheet" type="text/css"/>
<link href="/images/favicon.png" rel="shortcut icon" type="image/png" />
</head>
<body>
<div id="body">
<div id="contents">
<div id="header">
<a href="/">
<img alt="The best way to manage your application's dependencies" src="images/gembundler.png" width="725"/>
</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>
</div>
</div>
<div id="footer">
<img alt="Emocow" src="images/emocow.png"/>
<img alt="Panda" src="images/panda.jpg"/>
<div class="spacer"></div>
<div id="navigation">
<p>
<b>commands</b>
<a href="./index.html">home</a>
/
<a href="./bundle_install.html">install</a>
/
<a href="./bundle_package.html">package</a>
</p>
<p>
<b>usage</b>
<a href="./gemfile.html">gemfile</a>
/
<a href="./git.html">git</a>
/
<a href="./groups.html">groups</a>
/
<a href="./bundler_setup.html">setup</a>
/
<a href="./deploying.html">deploying</a>
</p>
<p>
<b>frameworks</b>
<a href="./rubygems.html">rubygems</a>
/
<a href="./sinatra.html">sinatra</a>
/
<a href="./rails23.html">rails 2.3</a>
/
<a href="./rails3.html">rails 3</a>
</p>
</div>
<div class="spacer"></div>
<img alt="Bundler small" src="images/bundler-small.png"/>
</div>
<div id="credits">
<p>Bundler icon and logo designed by <a href="http://twitter.com/johnneiner">John Neiner</a> and donated by <a href="http://pixelgraphics.us">Pixel Graphic Design Studio</a></p>
</div>
<a href="http://github.com/carlhuda/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">
<a class="" href="v0.9/index.html">v0.9</a>
<a class="current" href="v1.0/index.html">v1.0</a>
</div>
<div id="rc-versions">
<a class="" href="v1.1/index.html">v1.1 (coming soon)</a>
</div>
<script type="text/javascript">
//<![CDATA[
var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-557621-9']);
_gaq.push(['_trackPageview']);
(function() {
var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
})();
//]]>
</script>
</body>
</html>