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
|
<!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" />
</head>
<body>
<div id='body'>
<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>
<div id='container'>
<div id='contents'>
<h2>Gemfiles</h2>
<div class='contents'>
<div class='bullet'>
<div class='description'>
Gemfiles require at least one gem source, in the form of the URL for a Rubygems server.
There are shortcuts for the default gem server, so all of these sources are the same.
</div>
<pre class="highlight ruby"><span class="n">source</span> <span class="ss">:rubygems</span>
<span class="n">source</span> <span class="s1">'http://rubygems.org'</span>
<span class="n">source</span> <span class="ss">:rubyforge</span>
<span class="n">source</span> <span class="s1">'http://gems.rubyforge.org'</span>
<span class="n">source</span> <span class="ss">:gemcutter</span>
<span class="n">source</span> <span class="s1">'http://gemcutter.org'</span>
</pre>
</div>
<div class='bullet'>
<div class='description'>
Declare the gems that you need, including version numbers. Specify versions using the same
syntax that Rubygems supports for dependencies.
</div>
<pre class="highlight ruby"><span class="n">gem</span> <span class="s1">'nokogiri'</span>
<span class="n">gem</span> <span class="s1">'rails'</span><span class="p">,</span> <span class="s1">'3.0.0.beta3'</span>
<span class="n">gem</span> <span class="s1">'rack'</span><span class="p">,</span> <span class="s1">'>=1.0'</span>
<span class="n">gem</span> <span class="s1">'thin'</span><span class="p">,</span> <span class="s1">'~>1.1'</span>
</pre>
</div>
<div class='bullet'>
<div class='description'>
If a gem's main file is different than the gem name, specify how to require it.
</div>
<pre class="highlight ruby"><span class="n">gem</span> <span class="s1">'rspec'</span><span class="p">,</span> <span class="ss">:require</span> <span class="o">=></span> <span class="s1">'spec'</span>
<span class="n">gem</span> <span class="s1">'sqlite3'</span>
</pre>
</div>
<div class='bullet'>
<div class='description'>
Git repositories are also valid gem sources, as long as the repo contains one or more valid gems.
Specify what to check out with :tag, :branch, or :ref. The default is the master branch.
</div>
<pre class="highlight ruby"><span class="n">gem</span> <span class="s1">'nokogiri'</span><span class="p">,</span> <span class="ss">:git</span> <span class="o">=></span> <span class="s1">'https://github.com/tenderlove/nokogiri.git'</span><span class="p">,</span> <span class="ss">:branch</span> <span class="o">=></span> <span class="s1">'1.4'</span>

<span class="n">git</span> <span class="s1">'https://github.com/wycats/thor.git'</span><span class="p">,</span> <span class="ss">:tag</span> <span class="o">=></span> <span class="s1">'v0.13.4'</span>
<span class="n">gem</span> <span class="s1">'thor'</span></pre>
<a href="/v0.9/git.html">Learn more: Git</a>
</div>
<div class='bullet'>
<div class='description'>
If you are actively developing a gem, perhaps checked out from Github, you can use the gem
directly from its directory on your filesystem.
</div>
<pre class="highlight ruby"><span class="n">gem</span> <span class="s1">'nokogiri'</span><span class="p">,</span> <span class="ss">:path</span> <span class="o">=></span> <span class="s1">'~/sw/gems/nokogiri'</span>
</pre>
</div>
<div class='bullet'>
<div class='description'>
Dependencies can be placed into groups, to be ignored at install-time or required all at once.
</div>
<pre class="highlight ruby"><span class="n">gem</span> <span class="s1">'wirble'</span><span class="p">,</span> <span class="ss">:group</span> <span class="o">=></span> <span class="ss">:development</span>
<span class="n">gem</span> <span class="s1">'ruby-debug'</span><span class="p">,</span> <span class="ss">:group</span> <span class="o">=></span> <span class="o">[</span><span class="ss">:development</span><span class="p">,</span> <span class="ss">:test</span><span class="o">]</span>

<span class="n">group</span> <span class="ss">:test</span> <span class="k">do</span>
 <span class="n">gem</span> <span class="s1">'rspec'</span>
<span class="k">end</span></pre>
<a href="/v0.9/groups.html">Learn more: Groups</a>
</div>
</div>
</div>
</div>
</div>
<div id='footer'>
<img src="/images/emocow.png" />
<img src="/images/panda.jpg" />
<div class='spacer'></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>
<div class='spacer'></div>
<img src="/images/bundler-small.png" />
</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 class="current" href="/v0.9/">v0.9</a>
<a href="/v1.0/">v1.0</a>
<a href="/v1.1/">v1.1</a>
<a href="/v1.2/">v1.2</a>
<a href="/v1.3/">v1.3</a>
<a href="/v1.5/index.html">v1.5</a>
<a href="/">v1.6</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>
|