Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 102 lines (69 sloc) 3.154 kb
18c6fae @rogerleite Readme updated again. New release soon
authored
1 h1. Snapshot: A Rubygems plugin
8b09f05 @rogerleite First commit
authored
2
18c6fae @rogerleite Readme updated again. New release soon
authored
3 *Export and Import* your gems.
d1fbb4c @rogerleite Readme updated. New release soon
authored
4 Snapshot, copy your current gems in a single file, providing a fast and secure way to import your gems anywhere.
8b09f05 @rogerleite First commit
authored
5
18c6fae @rogerleite Readme updated again. New release soon
authored
6 Tested with:
28556cd @rogerleite Correction at bullet list. again :X
authored
7 * ruby-1.8.6-p399 [ i386 ]
8 * ruby-1.8.7-p249 [ i386 ]
9 * 1.3.6 gem version
8b09f05 @rogerleite First commit
authored
10
d1fbb4c @rogerleite Readme updated. New release soon
authored
11 Version 1 was based on ["Import/Export Patch":http://rubyforge.org/tracker/?atid=577&group_id=126&func=browse] from ["Peer Allan":http://rubyforge.org/users/pallan].
12
43bb600 @rogerleite Update README with install and usage instructions
authored
13 h2. Install/Usage
14
15 @gem install rubygems_snapshot@
16
17 After install, you can use:
18
d1fbb4c @rogerleite Readme updated. New release soon
authored
19 @gem snapshot export gems.tar@ to export your gems
43bb600 @rogerleite Update README with install and usage instructions
authored
20
d1fbb4c @rogerleite Readme updated. New release soon
authored
21 @gem snapshot import gems.tar@ to import (install) gems.
8face52 Some notices updates
Roger Leite authored
22
f7b69be @rogerleite Correction at bullet list
authored
23 *Important*: When importing, don't forget to use sudo if necessary *and* pay attention to errors relative to native build.
24 I don't know how to deal with that yet! :X
d1fbb4c @rogerleite Readme updated. New release soon
authored
25 *Hosted* at ["Gemcutter":http://gemcutter.org/gems/rubygems_snapshot]
26
27 h3. Others formats
28
29 Nowadays, it supports two formats:
28556cd @rogerleite Correction at bullet list. again :X
authored
30 * tar (default)
31 * yml
d1fbb4c @rogerleite Readme updated. New release soon
authored
32
33 You can chose the format, using -f parameter. For example:
34
35 @gem snapshot export gems.yml -f yml@
36 @gem snapshot import gems.yml -f yml@
37
38 For aditional help, execute:
39 @gem help snapshot@
40
eccbfc3 @rogerleite Developer section
authored
41 h3. How it Works?
d1fbb4c @rogerleite Readme updated. New release soon
authored
42
43 It's very simple.
44 *When exporting*, get all gems (like "gem list"), puts in a yml file.
45 If gem file exists at cache folder from rubygems, copy to tar file too. (tar format)
46
47 *When importing*, copy all gems to rubygems cache folder.
48 Read the yml file, install the gem file from cache folder or do a simple "gem install" if gem file does not exists.
49
eccbfc3 @rogerleite Developer section
authored
50 h2. For Developers
d1fbb4c @rogerleite Readme updated. New release soon
authored
51
eccbfc3 @rogerleite Developer section
authored
52 h3. Using as API
53
54 <pre>
55 require "rubygems"
56 GemsSnapshot::Exporter.export("example.tar", :format => :tar)
57 </pre>
e6aa317 @rogerleite Trying to correct pre tags at Readme
authored
58
eccbfc3 @rogerleite Developer section
authored
59 --
e6aa317 @rogerleite Trying to correct pre tags at Readme
authored
60
eccbfc3 @rogerleite Developer section
authored
61 <pre>
62 require "rubygems"
63 GemsSnapshot::Importer.import("example.tar", :format => :tar)
64 </pre>
65
e6aa317 @rogerleite Trying to correct pre tags at Readme
authored
66
eccbfc3 @rogerleite Developer section
authored
67 h3. Use the sources Luke!
68
69 If you want help to improve Snapshot, after git clone, you'll need the following gems:
28556cd @rogerleite Correction at bullet list. again :X
authored
70 * rake
71 * rspec
72 * cucumber
d1fbb4c @rogerleite Readme updated. New release soon
authored
73
74 Use "rake -T" to see the available tasks.
75 I highly recomend using ["RVM":http://rvm.beginrescueend.com/] during development.
eccbfc3 @rogerleite Developer section
authored
76 Anything, questions, suggestions etc., send me message or leave a issue.
43bb600 @rogerleite Update README with install and usage instructions
authored
77
8b09f05 @rogerleite First commit
authored
78 h2. License
79
80 (The MIT License)
81
8face52 Some notices updates
Roger Leite authored
82 Copyright (c) 2009 Roger Leite
8b09f05 @rogerleite First commit
authored
83
84 Permission is hereby granted, free of charge, to any person obtaining
85 a copy of this software and associated documentation files (the
86 'Software'), to deal in the Software without restriction, including
87 without limitation the rights to use, copy, modify, merge, publish,
88 distribute, sublicense, and/or sell copies of the Software, and to
89 permit persons to whom the Software is furnished to do so, subject to
90 the following conditions:
91
92 The above copyright notice and this permission notice shall be
93 included in all copies or substantial portions of the Software.
94
95 THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
96 EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
97 MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
98 IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
99 CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
100 TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
101 SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Something went wrong with that request. Please try again.