epublishing-rails-plugin-installer 6.0.3

Sign up to get free protection for your applications and to get access to all the features.
data/CHANGELOG ADDED
@@ -0,0 +1 @@
1
+ v6.0.3. Move to github
data/LICENSE ADDED
@@ -0,0 +1,481 @@
1
+ GNU LIBRARY GENERAL PUBLIC LICENSE
2
+ Version 2, June 1991
3
+
4
+ Copyright (C) 1991 Free Software Foundation, Inc.
5
+ 675 Mass Ave, Cambridge, MA 02139, USA
6
+ Everyone is permitted to copy and distribute verbatim copies
7
+ of this license document, but changing it is not allowed.
8
+
9
+ [This is the first released version of the library GPL. It is
10
+ numbered 2 because it goes with version 2 of the ordinary GPL.]
11
+
12
+ Preamble
13
+
14
+ The licenses for most software are designed to take away your
15
+ freedom to share and change it. By contrast, the GNU General Public
16
+ Licenses are intended to guarantee your freedom to share and change
17
+ free software--to make sure the software is free for all its users.
18
+
19
+ This license, the Library General Public License, applies to some
20
+ specially designated Free Software Foundation software, and to any
21
+ other libraries whose authors decide to use it. You can use it for
22
+ your libraries, too.
23
+
24
+ When we speak of free software, we are referring to freedom, not
25
+ price. Our General Public Licenses are designed to make sure that you
26
+ have the freedom to distribute copies of free software (and charge for
27
+ this service if you wish), that you receive source code or can get it
28
+ if you want it, that you can change the software or use pieces of it
29
+ in new free programs; and that you know you can do these things.
30
+
31
+ To protect your rights, we need to make restrictions that forbid
32
+ anyone to deny you these rights or to ask you to surrender the rights.
33
+ These restrictions translate to certain responsibilities for you if
34
+ you distribute copies of the library, or if you modify it.
35
+
36
+ For example, if you distribute copies of the library, whether gratis
37
+ or for a fee, you must give the recipients all the rights that we gave
38
+ you. You must make sure that they, too, receive or can get the source
39
+ code. If you link a program with the library, you must provide
40
+ complete object files to the recipients so that they can relink them
41
+ with the library, after making changes to the library and recompiling
42
+ it. And you must show them these terms so they know their rights.
43
+
44
+ Our method of protecting your rights has two steps: (1) copyright
45
+ the library, and (2) offer you this license which gives you legal
46
+ permission to copy, distribute and/or modify the library.
47
+
48
+ Also, for each distributor's protection, we want to make certain
49
+ that everyone understands that there is no warranty for this free
50
+ library. If the library is modified by someone else and passed on, we
51
+ want its recipients to know that what they have is not the original
52
+ version, so that any problems introduced by others will not reflect on
53
+ the original authors' reputations.
54
+
55
+ Finally, any free program is threatened constantly by software
56
+ patents. We wish to avoid the danger that companies distributing free
57
+ software will individually obtain patent licenses, thus in effect
58
+ transforming the program into proprietary software. To prevent this,
59
+ we have made it clear that any patent must be licensed for everyone's
60
+ free use or not licensed at all.
61
+
62
+ Most GNU software, including some libraries, is covered by the ordinary
63
+ GNU General Public License, which was designed for utility programs. This
64
+ license, the GNU Library General Public License, applies to certain
65
+ designated libraries. This license is quite different from the ordinary
66
+ one; be sure to read it in full, and don't assume that anything in it is
67
+ the same as in the ordinary license.
68
+
69
+ The reason we have a separate public license for some libraries is that
70
+ they blur the distinction we usually make between modifying or adding to a
71
+ program and simply using it. Linking a program with a library, without
72
+ changing the library, is in some sense simply using the library, and is
73
+ analogous to running a utility program or application program. However, in
74
+ a textual and legal sense, the linked executable is a combined work, a
75
+ derivative of the original library, and the ordinary General Public License
76
+ treats it as such.
77
+
78
+ Because of this blurred distinction, using the ordinary General
79
+ Public License for libraries did not effectively promote software
80
+ sharing, because most developers did not use the libraries. We
81
+ concluded that weaker conditions might promote sharing better.
82
+
83
+ However, unrestricted linking of non-free programs would deprive the
84
+ users of those programs of all benefit from the free status of the
85
+ libraries themselves. This Library General Public License is intended to
86
+ permit developers of non-free programs to use free libraries, while
87
+ preserving your freedom as a user of such programs to change the free
88
+ libraries that are incorporated in them. (We have not seen how to achieve
89
+ this as regards changes in header files, but we have achieved it as regards
90
+ changes in the actual functions of the Library.) The hope is that this
91
+ will lead to faster development of free libraries.
92
+
93
+ The precise terms and conditions for copying, distribution and
94
+ modification follow. Pay close attention to the difference between a
95
+ "work based on the library" and a "work that uses the library". The
96
+ former contains code derived from the library, while the latter only
97
+ works together with the library.
98
+
99
+ Note that it is possible for a library to be covered by the ordinary
100
+ General Public License rather than by this special one.
101
+
102
+ GNU LIBRARY GENERAL PUBLIC LICENSE
103
+ TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
104
+
105
+ 0. This License Agreement applies to any software library which
106
+ contains a notice placed by the copyright holder or other authorized
107
+ party saying it may be distributed under the terms of this Library
108
+ General Public License (also called "this License"). Each licensee is
109
+ addressed as "you".
110
+
111
+ A "library" means a collection of software functions and/or data
112
+ prepared so as to be conveniently linked with application programs
113
+ (which use some of those functions and data) to form executables.
114
+
115
+ The "Library", below, refers to any such software library or work
116
+ which has been distributed under these terms. A "work based on the
117
+ Library" means either the Library or any derivative work under
118
+ copyright law: that is to say, a work containing the Library or a
119
+ portion of it, either verbatim or with modifications and/or translated
120
+ straightforwardly into another language. (Hereinafter, translation is
121
+ included without limitation in the term "modification".)
122
+
123
+ "Source code" for a work means the preferred form of the work for
124
+ making modifications to it. For a library, complete source code means
125
+ all the source code for all modules it contains, plus any associated
126
+ interface definition files, plus the scripts used to control compilation
127
+ and installation of the library.
128
+
129
+ Activities other than copying, distribution and modification are not
130
+ covered by this License; they are outside its scope. The act of
131
+ running a program using the Library is not restricted, and output from
132
+ such a program is covered only if its contents constitute a work based
133
+ on the Library (independent of the use of the Library in a tool for
134
+ writing it). Whether that is true depends on what the Library does
135
+ and what the program that uses the Library does.
136
+
137
+ 1. You may copy and distribute verbatim copies of the Library's
138
+ complete source code as you receive it, in any medium, provided that
139
+ you conspicuously and appropriately publish on each copy an
140
+ appropriate copyright notice and disclaimer of warranty; keep intact
141
+ all the notices that refer to this License and to the absence of any
142
+ warranty; and distribute a copy of this License along with the
143
+ Library.
144
+
145
+ You may charge a fee for the physical act of transferring a copy,
146
+ and you may at your option offer warranty protection in exchange for a
147
+ fee.
148
+
149
+ 2. You may modify your copy or copies of the Library or any portion
150
+ of it, thus forming a work based on the Library, and copy and
151
+ distribute such modifications or work under the terms of Section 1
152
+ above, provided that you also meet all of these conditions:
153
+
154
+ a) The modified work must itself be a software library.
155
+
156
+ b) You must cause the files modified to carry prominent notices
157
+ stating that you changed the files and the date of any change.
158
+
159
+ c) You must cause the whole of the work to be licensed at no
160
+ charge to all third parties under the terms of this License.
161
+
162
+ d) If a facility in the modified Library refers to a function or a
163
+ table of data to be supplied by an application program that uses
164
+ the facility, other than as an argument passed when the facility
165
+ is invoked, then you must make a good faith effort to ensure that,
166
+ in the event an application does not supply such function or
167
+ table, the facility still operates, and performs whatever part of
168
+ its purpose remains meaningful.
169
+
170
+ (For example, a function in a library to compute square roots has
171
+ a purpose that is entirely well-defined independent of the
172
+ application. Therefore, Subsection 2d requires that any
173
+ application-supplied function or table used by this function must
174
+ be optional: if the application does not supply it, the square
175
+ root function must still compute square roots.)
176
+
177
+ These requirements apply to the modified work as a whole. If
178
+ identifiable sections of that work are not derived from the Library,
179
+ and can be reasonably considered independent and separate works in
180
+ themselves, then this License, and its terms, do not apply to those
181
+ sections when you distribute them as separate works. But when you
182
+ distribute the same sections as part of a whole which is a work based
183
+ on the Library, the distribution of the whole must be on the terms of
184
+ this License, whose permissions for other licensees extend to the
185
+ entire whole, and thus to each and every part regardless of who wrote
186
+ it.
187
+
188
+ Thus, it is not the intent of this section to claim rights or contest
189
+ your rights to work written entirely by you; rather, the intent is to
190
+ exercise the right to control the distribution of derivative or
191
+ collective works based on the Library.
192
+
193
+ In addition, mere aggregation of another work not based on the Library
194
+ with the Library (or with a work based on the Library) on a volume of
195
+ a storage or distribution medium does not bring the other work under
196
+ the scope of this License.
197
+
198
+ 3. You may opt to apply the terms of the ordinary GNU General Public
199
+ License instead of this License to a given copy of the Library. To do
200
+ this, you must alter all the notices that refer to this License, so
201
+ that they refer to the ordinary GNU General Public License, version 2,
202
+ instead of to this License. (If a newer version than version 2 of the
203
+ ordinary GNU General Public License has appeared, then you can specify
204
+ that version instead if you wish.) Do not make any other change in
205
+ these notices.
206
+
207
+ Once this change is made in a given copy, it is irreversible for
208
+ that copy, so the ordinary GNU General Public License applies to all
209
+ subsequent copies and derivative works made from that copy.
210
+
211
+ This option is useful when you wish to copy part of the code of
212
+ the Library into a program that is not a library.
213
+
214
+ 4. You may copy and distribute the Library (or a portion or
215
+ derivative of it, under Section 2) in object code or executable form
216
+ under the terms of Sections 1 and 2 above provided that you accompany
217
+ it with the complete corresponding machine-readable source code, which
218
+ must be distributed under the terms of Sections 1 and 2 above on a
219
+ medium customarily used for software interchange.
220
+
221
+ If distribution of object code is made by offering access to copy
222
+ from a designated place, then offering equivalent access to copy the
223
+ source code from the same place satisfies the requirement to
224
+ distribute the source code, even though third parties are not
225
+ compelled to copy the source along with the object code.
226
+
227
+ 5. A program that contains no derivative of any portion of the
228
+ Library, but is designed to work with the Library by being compiled or
229
+ linked with it, is called a "work that uses the Library". Such a
230
+ work, in isolation, is not a derivative work of the Library, and
231
+ therefore falls outside the scope of this License.
232
+
233
+ However, linking a "work that uses the Library" with the Library
234
+ creates an executable that is a derivative of the Library (because it
235
+ contains portions of the Library), rather than a "work that uses the
236
+ library". The executable is therefore covered by this License.
237
+ Section 6 states terms for distribution of such executables.
238
+
239
+ When a "work that uses the Library" uses material from a header file
240
+ that is part of the Library, the object code for the work may be a
241
+ derivative work of the Library even though the source code is not.
242
+ Whether this is true is especially significant if the work can be
243
+ linked without the Library, or if the work is itself a library. The
244
+ threshold for this to be true is not precisely defined by law.
245
+
246
+ If such an object file uses only numerical parameters, data
247
+ structure layouts and accessors, and small macros and small inline
248
+ functions (ten lines or less in length), then the use of the object
249
+ file is unrestricted, regardless of whether it is legally a derivative
250
+ work. (Executables containing this object code plus portions of the
251
+ Library will still fall under Section 6.)
252
+
253
+ Otherwise, if the work is a derivative of the Library, you may
254
+ distribute the object code for the work under the terms of Section 6.
255
+ Any executables containing that work also fall under Section 6,
256
+ whether or not they are linked directly with the Library itself.
257
+
258
+ 6. As an exception to the Sections above, you may also compile or
259
+ link a "work that uses the Library" with the Library to produce a
260
+ work containing portions of the Library, and distribute that work
261
+ under terms of your choice, provided that the terms permit
262
+ modification of the work for the customer's own use and reverse
263
+ engineering for debugging such modifications.
264
+
265
+ You must give prominent notice with each copy of the work that the
266
+ Library is used in it and that the Library and its use are covered by
267
+ this License. You must supply a copy of this License. If the work
268
+ during execution displays copyright notices, you must include the
269
+ copyright notice for the Library among them, as well as a reference
270
+ directing the user to the copy of this License. Also, you must do one
271
+ of these things:
272
+
273
+ a) Accompany the work with the complete corresponding
274
+ machine-readable source code for the Library including whatever
275
+ changes were used in the work (which must be distributed under
276
+ Sections 1 and 2 above); and, if the work is an executable linked
277
+ with the Library, with the complete machine-readable "work that
278
+ uses the Library", as object code and/or source code, so that the
279
+ user can modify the Library and then relink to produce a modified
280
+ executable containing the modified Library. (It is understood
281
+ that the user who changes the contents of definitions files in the
282
+ Library will not necessarily be able to recompile the application
283
+ to use the modified definitions.)
284
+
285
+ b) Accompany the work with a written offer, valid for at
286
+ least three years, to give the same user the materials
287
+ specified in Subsection 6a, above, for a charge no more
288
+ than the cost of performing this distribution.
289
+
290
+ c) If distribution of the work is made by offering access to copy
291
+ from a designated place, offer equivalent access to copy the above
292
+ specified materials from the same place.
293
+
294
+ d) Verify that the user has already received a copy of these
295
+ materials or that you have already sent this user a copy.
296
+
297
+ For an executable, the required form of the "work that uses the
298
+ Library" must include any data and utility programs needed for
299
+ reproducing the executable from it. However, as a special exception,
300
+ the source code distributed need not include anything that is normally
301
+ distributed (in either source or binary form) with the major
302
+ components (compiler, kernel, and so on) of the operating system on
303
+ which the executable runs, unless that component itself accompanies
304
+ the executable.
305
+
306
+ It may happen that this requirement contradicts the license
307
+ restrictions of other proprietary libraries that do not normally
308
+ accompany the operating system. Such a contradiction means you cannot
309
+ use both them and the Library together in an executable that you
310
+ distribute.
311
+
312
+ 7. You may place library facilities that are a work based on the
313
+ Library side-by-side in a single library together with other library
314
+ facilities not covered by this License, and distribute such a combined
315
+ library, provided that the separate distribution of the work based on
316
+ the Library and of the other library facilities is otherwise
317
+ permitted, and provided that you do these two things:
318
+
319
+ a) Accompany the combined library with a copy of the same work
320
+ based on the Library, uncombined with any other library
321
+ facilities. This must be distributed under the terms of the
322
+ Sections above.
323
+
324
+ b) Give prominent notice with the combined library of the fact
325
+ that part of it is a work based on the Library, and explaining
326
+ where to find the accompanying uncombined form of the same work.
327
+
328
+ 8. You may not copy, modify, sublicense, link with, or distribute
329
+ the Library except as expressly provided under this License. Any
330
+ attempt otherwise to copy, modify, sublicense, link with, or
331
+ distribute the Library is void, and will automatically terminate your
332
+ rights under this License. However, parties who have received copies,
333
+ or rights, from you under this License will not have their licenses
334
+ terminated so long as such parties remain in full compliance.
335
+
336
+ 9. You are not required to accept this License, since you have not
337
+ signed it. However, nothing else grants you permission to modify or
338
+ distribute the Library or its derivative works. These actions are
339
+ prohibited by law if you do not accept this License. Therefore, by
340
+ modifying or distributing the Library (or any work based on the
341
+ Library), you indicate your acceptance of this License to do so, and
342
+ all its terms and conditions for copying, distributing or modifying
343
+ the Library or works based on it.
344
+
345
+ 10. Each time you redistribute the Library (or any work based on the
346
+ Library), the recipient automatically receives a license from the
347
+ original licensor to copy, distribute, link with or modify the Library
348
+ subject to these terms and conditions. You may not impose any further
349
+ restrictions on the recipients' exercise of the rights granted herein.
350
+ You are not responsible for enforcing compliance by third parties to
351
+ this License.
352
+
353
+ 11. If, as a consequence of a court judgment or allegation of patent
354
+ infringement or for any other reason (not limited to patent issues),
355
+ conditions are imposed on you (whether by court order, agreement or
356
+ otherwise) that contradict the conditions of this License, they do not
357
+ excuse you from the conditions of this License. If you cannot
358
+ distribute so as to satisfy simultaneously your obligations under this
359
+ License and any other pertinent obligations, then as a consequence you
360
+ may not distribute the Library at all. For example, if a patent
361
+ license would not permit royalty-free redistribution of the Library by
362
+ all those who receive copies directly or indirectly through you, then
363
+ the only way you could satisfy both it and this License would be to
364
+ refrain entirely from distribution of the Library.
365
+
366
+ If any portion of this section is held invalid or unenforceable under any
367
+ particular circumstance, the balance of the section is intended to apply,
368
+ and the section as a whole is intended to apply in other circumstances.
369
+
370
+ It is not the purpose of this section to induce you to infringe any
371
+ patents or other property right claims or to contest validity of any
372
+ such claims; this section has the sole purpose of protecting the
373
+ integrity of the free software distribution system which is
374
+ implemented by public license practices. Many people have made
375
+ generous contributions to the wide range of software distributed
376
+ through that system in reliance on consistent application of that
377
+ system; it is up to the author/donor to decide if he or she is willing
378
+ to distribute software through any other system and a licensee cannot
379
+ impose that choice.
380
+
381
+ This section is intended to make thoroughly clear what is believed to
382
+ be a consequence of the rest of this License.
383
+
384
+ 12. If the distribution and/or use of the Library is restricted in
385
+ certain countries either by patents or by copyrighted interfaces, the
386
+ original copyright holder who places the Library under this License may add
387
+ an explicit geographical distribution limitation excluding those countries,
388
+ so that distribution is permitted only in or among countries not thus
389
+ excluded. In such case, this License incorporates the limitation as if
390
+ written in the body of this License.
391
+
392
+ 13. The Free Software Foundation may publish revised and/or new
393
+ versions of the Library General Public License from time to time.
394
+ Such new versions will be similar in spirit to the present version,
395
+ but may differ in detail to address new problems or concerns.
396
+
397
+ Each version is given a distinguishing version number. If the Library
398
+ specifies a version number of this License which applies to it and
399
+ "any later version", you have the option of following the terms and
400
+ conditions either of that version or of any later version published by
401
+ the Free Software Foundation. If the Library does not specify a
402
+ license version number, you may choose any version ever published by
403
+ the Free Software Foundation.
404
+
405
+ 14. If you wish to incorporate parts of the Library into other free
406
+ programs whose distribution conditions are incompatible with these,
407
+ write to the author to ask for permission. For software which is
408
+ copyrighted by the Free Software Foundation, write to the Free
409
+ Software Foundation; we sometimes make exceptions for this. Our
410
+ decision will be guided by the two goals of preserving the free status
411
+ of all derivatives of our free software and of promoting the sharing
412
+ and reuse of software generally.
413
+
414
+ NO WARRANTY
415
+
416
+ 15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO
417
+ WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
418
+ EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
419
+ OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY
420
+ KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
421
+ IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
422
+ PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
423
+ LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME
424
+ THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
425
+
426
+ 16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
427
+ WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
428
+ AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU
429
+ FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
430
+ CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
431
+ LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
432
+ RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
433
+ FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
434
+ SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
435
+ DAMAGES.
436
+
437
+ END OF TERMS AND CONDITIONS
438
+
439
+ Appendix: How to Apply These Terms to Your New Libraries
440
+
441
+ If you develop a new library, and you want it to be of the greatest
442
+ possible use to the public, we recommend making it free software that
443
+ everyone can redistribute and change. You can do so by permitting
444
+ redistribution under these terms (or, alternatively, under the terms of the
445
+ ordinary General Public License).
446
+
447
+ To apply these terms, attach the following notices to the library. It is
448
+ safest to attach them to the start of each source file to most effectively
449
+ convey the exclusion of warranty; and each file should have at least the
450
+ "copyright" line and a pointer to where the full notice is found.
451
+
452
+ <one line to give the library's name and a brief idea of what it does.>
453
+ Copyright (C) <year> <name of author>
454
+
455
+ This library is free software; you can redistribute it and/or
456
+ modify it under the terms of the GNU Library General Public
457
+ License as published by the Free Software Foundation; either
458
+ version 2 of the License, or (at your option) any later version.
459
+
460
+ This library is distributed in the hope that it will be useful,
461
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
462
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
463
+ Library General Public License for more details.
464
+
465
+ You should have received a copy of the GNU Library General Public
466
+ License along with this library; if not, write to the Free
467
+ Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
468
+
469
+ Also add information on how to contact you by electronic and paper mail.
470
+
471
+ You should also get your employer (if you work as a programmer) or your
472
+ school, if any, to sign a "copyright disclaimer" for the library, if
473
+ necessary. Here is a sample; alter the names:
474
+
475
+ Yoyodyne, Inc., hereby disclaims all copyright interest in the
476
+ library `Frob' (a library for tweaking knobs) written by James Random Hacker.
477
+
478
+ <signature of Ty Coon>, 1 April 1990
479
+ Ty Coon, President of Vice
480
+
481
+ That's all there is to it!
data/Manifest ADDED
@@ -0,0 +1,9 @@
1
+ CHANGELOG
2
+ LICENSE
3
+ README.rdoc
4
+ Rakefile
5
+ bin/epub-plugin
6
+ lib/commands/epub-plugin.rb
7
+ lib/epublishing/tgz_builder.rb
8
+ lib/epublishing/tgz_extractor.rb
9
+ Manifest
data/README.rdoc ADDED
@@ -0,0 +1,36 @@
1
+ = EpublishingRailsPluginInstaller - An extension of standard rails plugin script
2
+ to provide support for local file system and tgz files
3
+
4
+ == Introduction
5
+
6
+ The standard rails 'plugin' script lacks support for installing
7
+ from the local file system as well as installing tar.gz files.
8
+ (The latter scenario greatly speeds up installation from http
9
+ as the alternative is downloading each file, one-by-one.)
10
+
11
+ This class piggy-backs on the standard rails 'plugin' command and
12
+ can be used as a complete replacement if so desired.
13
+
14
+ === Installation
15
+
16
+ gem install epublishing-rails-plugin-installer
17
+
18
+ === Git Repository
19
+
20
+ http://github.com/ePublishing/epublishing-rails-plugin-installer
21
+
22
+ == Prerequisites
23
+
24
+ The EpublishingRailsPluginInstaller gem depends on rubygems and
25
+ rails.
26
+
27
+ == Usage
28
+
29
+ epub-plugin install /some/location/on/the/disk
30
+ epub-plugin install http://somewhere.com/foo/a_plugin.tgz
31
+ epub-plugin install http://somewhere.com/foo/another_plugin.tar.gz
32
+
33
+ ---
34
+ Author:: David McCullars <mailto:dmccullars@ePublishing.com>
35
+ Copyright:: (C) 2011 ePublishing
36
+ Licence:: GPL[http://www.gnu.org/copyleft/gpl.html]
data/Rakefile ADDED
@@ -0,0 +1,28 @@
1
+ require 'rake'
2
+ require 'echoe'
3
+ require 'rake/rdoctask'
4
+
5
+ task :default => :gem
6
+
7
+ Echoe.new("epublishing-rails-plugin-installer") do |s|
8
+ s.author = "David McCullars"
9
+ s.project = "epublishing-rails-plugin-installer"
10
+ s.email = "dmccullars@ePublishing.com"
11
+ s.url = "http://github.com/ePublishing/epublishing-rails-plugin-installer"
12
+ s.docs_host = "http://rdoc.info/github/ePublishing/epublishing-rails-plugin-installer/master/frames"
13
+ s.rdoc_pattern = /README|TODO|LICENSE|CHANGELOG|BENCH|COMPAT|exceptions|behaviors|epub-plugin.rb/
14
+ s.clean_pattern += ["ext/lib", "ext/include", "ext/share", "ext/libepublishing-rails-plugin-installer-?.??", "ext/bin", "ext/conftest.dSYM"]
15
+ s.summary = 'An extension of standard rails plugin script to provide support for local file system and tgz files'
16
+ end
17
+
18
+ desc 'generate API documentation to doc/rdocs/index.html'
19
+ Rake::RDocTask.new do |rd|
20
+ rd.rdoc_dir = 'doc/rdocs'
21
+ rd.main = 'README.rdoc'
22
+ rd.rdoc_files.include 'README.rdoc', 'CHANGELOG', 'lib/**/*.rb'
23
+ rd.rdoc_files.exclude '**/string_ext.rb', '**/net_https_hack.rb'
24
+ rd.options << '--inline-source'
25
+ rd.options << '--line-numbers'
26
+ rd.options << '--all'
27
+ rd.options << '--fileboxes'
28
+ end
data/bin/epub-plugin ADDED
@@ -0,0 +1,3 @@
1
+ #!/usr/bin/env ruby
2
+ require File.expand_path('config/boot', Dir.pwd)
3
+ require 'commands/epub-plugin'
@@ -0,0 +1,31 @@
1
+ # -*- encoding: utf-8 -*-
2
+
3
+ Gem::Specification.new do |s|
4
+ s.name = %q{epublishing-rails-plugin-installer}
5
+ s.version = "6.0.3"
6
+
7
+ s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
8
+ s.authors = ["David McCullars"]
9
+ s.date = %q{2011-04-26}
10
+ s.default_executable = %q{epub-plugin}
11
+ s.description = %q{An extension of standard rails plugin script to provide support for local file system and tgz files}
12
+ s.email = %q{dmccullars@ePublishing.com}
13
+ s.executables = ["epub-plugin"]
14
+ s.extra_rdoc_files = ["CHANGELOG", "LICENSE", "README.rdoc", "lib/commands/epub-plugin.rb"]
15
+ s.files = ["CHANGELOG", "LICENSE", "README.rdoc", "Rakefile", "bin/epub-plugin", "lib/commands/epub-plugin.rb", "lib/epublishing/tgz_builder.rb", "lib/epublishing/tgz_extractor.rb", "Manifest", "epublishing-rails-plugin-installer.gemspec"]
16
+ s.homepage = %q{http://github.com/ePublishing/epublishing-rails-plugin-installer}
17
+ s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Epublishing-rails-plugin-installer", "--main", "README.rdoc"]
18
+ s.require_paths = ["lib"]
19
+ s.rubyforge_project = %q{epublishing-rails-plugin-installer}
20
+ s.rubygems_version = %q{1.6.1}
21
+ s.summary = %q{An extension of standard rails plugin script to provide support for local file system and tgz files}
22
+
23
+ if s.respond_to? :specification_version then
24
+ s.specification_version = 3
25
+
26
+ if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
27
+ else
28
+ end
29
+ else
30
+ end
31
+ end
@@ -0,0 +1,105 @@
1
+ #--
2
+ # epub-plugin.rb - class to add functionality to standard rails 'plugin' script
3
+ #++
4
+ #
5
+ # == Overview
6
+ #
7
+ # The standard rails 'plugin' script lacks support for installing
8
+ # from the local file system as well as installing tar.gz files.
9
+ # (The latter scenario greatly speeds up installation from http
10
+ # as the alternative is downloading each file, one-by-one.)
11
+ #
12
+ # This class piggy-backs on the standard rails 'plugin' command and
13
+ # can be used as a complete replacement if so desired.
14
+ #
15
+ # == Example
16
+ #
17
+ # epub-plugin install /some/location/on/the/disk
18
+ # epub-plugin install http://somewhere.com/foo/a_plugin.tgz
19
+ # epub-plugin install http://somewhere.com/foo/another_plugin.tar.gz
20
+ #
21
+ # == Contact
22
+ #
23
+ # - David McCullars <dmccullars@ePublishing.com>
24
+ #
25
+
26
+ require 'tmpdir'
27
+ require 'rubygems'
28
+ require 'epublishing/tgz_extractor'
29
+
30
+ gem "rails"
31
+
32
+ rails_plugin = File.expand_path "../../lib/commands/plugin.rb", Gem.datadir("rails")
33
+ eval File.read(rails_plugin).sub(/^Commands::Plugin.parse!/, "")
34
+
35
+ RailsEnvironment.class_eval do
36
+
37
+ # Fix a bug in rails that assumes plugin is svn-based
38
+ alias :externals_without_non_svn= :externals=
39
+ def externals_with_non_svn=(items)
40
+ send(:externals_without_non_svn=, items) unless items.nil? or items.empty?
41
+ end
42
+ alias :externals= :externals_with_non_svn=
43
+
44
+ end
45
+
46
+ Plugin.class_eval do
47
+
48
+ class << self
49
+ alias :find_without_file_existence_check :find
50
+ def find_with_file_existence_check(name)
51
+ File.exists?(name) ? new(name) : find_without_file_existence_check(name)
52
+ end
53
+ alias :find :find_with_file_existence_check
54
+ end
55
+
56
+ alias :guess_name_without_tgz_support :guess_name
57
+ def guess_name_with_tgz_support(url)
58
+ guess_name_without_tgz_support(url)
59
+ @name.gsub!(/\.t(ar\.)?gz$/, '')
60
+ end
61
+ alias :guess_name :guess_name_with_tgz_support
62
+
63
+ alias :install_without_tgz_and_file_support :install
64
+ def install_with_tgz_and_file_support(method=nil, options = {})
65
+ method = :tgz if @uri =~ /\.t(ar\.)?gz$/
66
+ method = :file if File.exists?(@uri) and File.directory?(@uri)
67
+ install_without_tgz_and_file_support(method, options)
68
+ end
69
+ alias :install :install_with_tgz_and_file_support
70
+
71
+ def install_using_tgz(options = {})
72
+ temp_file = nil
73
+ mkdir_p(install_path = "#{rails_env.root}/vendor/plugins/#{name}")
74
+ if @uri =~ /https?:/
75
+ temp_file = File.join(Dir.tmpdir, "#{name}_#{Time.now.to_f.to_s}.tar.gz")
76
+ puts "Downloading #{@uri} to #{temp_file}"
77
+ io = File::open(temp_file, 'wb')
78
+ open(@uri) {|d| io.write d.read }
79
+ io.flush
80
+ io.close
81
+ @uri = temp_file
82
+ else
83
+ @uri = File.expand_path(@uri)
84
+ end
85
+ Dir.chdir(install_path) do
86
+ system(%Q[tar xvzf "#{@uri}"]) or
87
+ Epublishing::TgzExtractor.extract(@uri, install_path, true)
88
+ end
89
+ ensure
90
+ rm temp_file unless temp_file.nil?
91
+ end
92
+
93
+ def install_using_file(options = {})
94
+ plugins_dir = "#{rails_env.root}/vendor/plugins"
95
+ mkdir_p(install_path = "#{plugins_dir}/#{name}")
96
+ puts "Copying from #{@uri}" if $verbose
97
+ cp_r(@uri, plugins_dir)
98
+ Dir.chdir install_path do
99
+ rm_rf %w(.git .gitignore README)
100
+ end
101
+ end
102
+
103
+ end
104
+
105
+ Commands::Plugin.parse!
@@ -0,0 +1,53 @@
1
+ #--
2
+ # tgz_builder.rb - class for building a tgz (or tar.gz) file
3
+ #++
4
+ #
5
+ # == Overview
6
+ #
7
+ # Yes, yes, in the unixy world we can just `tar czf`, but such
8
+ # functionality is not universal. Instead, we piggy-back on tar
9
+ # support built into rubygems (which we assume is installed) and
10
+ # utilize the Zlib library (again assumed to be installed as it
11
+ # is required by rubygems).
12
+ #
13
+ # == Example
14
+ #
15
+ # TgzBuilder.build('some_src_file.tar.gz', 'some_src_folder')
16
+ # TgzBuilder.build('some_src_file.tar.gz', 'some_src_folder', true) # Prints files as they are built
17
+ #
18
+ # == Contact
19
+ #
20
+ # - David McCullars <dmccullars@ePublishing.com>
21
+ #
22
+
23
+ require 'fileutils'
24
+ require 'rubygems'
25
+ require 'rubygems/package'
26
+
27
+ module Epublishing
28
+ class TgzBuilder
29
+
30
+ def self.build(dest, srcdir, verbose=false)
31
+ parent_idx = File.dirname(srcdir).size + 1
32
+ tar_io = StringIO.new
33
+ Gem::Package::TarWriter.new(tar_io) do |tar|
34
+ Dir[File.join srcdir, '**', '**'].each do |file|
35
+ name = file[parent_idx, file.size].sub(/^\.+\//, '')
36
+ mode = File.stat(file).mode
37
+ if File.directory?(file)
38
+ tar.mkdir(name, mode)
39
+ else
40
+ tar.add_file(name, mode) do |out_io|
41
+ File.open(file, 'rb') { |in_io| out_io.write in_io.read }
42
+ end
43
+ end
44
+ puts "+ #{name}" if verbose
45
+ end
46
+ end
47
+ Zlib::GzipWriter.open(dest) do |gz|
48
+ gz.write tar_io.string
49
+ end
50
+ end
51
+
52
+ end
53
+ end
@@ -0,0 +1,50 @@
1
+ #--
2
+ # tgz_extractor.rb - class for extracting a tgz (or tar.gz) file
3
+ #++
4
+ #
5
+ # == Overview
6
+ #
7
+ # Yes, yes, in the unixy world we can just `tar xzf`, but such
8
+ # functionality is not universal. Instead, we piggy-back on tar
9
+ # support built into rubygems (which we assume is installed) and
10
+ # utilize the Zlib library (again assumed to be installed as it
11
+ # is required by rubygems).
12
+ #
13
+ # == Example
14
+ #
15
+ # TgzExtractor.extract('some_src_file.tar.gz', 'some_dest_folder')
16
+ # TgzExtractor.extract('some_src_file.tar.gz', 'some_dest_folder', true) # Prints files as they are extracted
17
+ #
18
+ # == Contact
19
+ #
20
+ # - David McCullars <dmccullars@ePublishing.com>
21
+ #
22
+
23
+ require 'fileutils'
24
+ require 'rubygems'
25
+ require 'rubygems/package'
26
+
27
+ module Epublishing
28
+ class TgzExtractor < Gem::Package::TarInput
29
+
30
+ def self.extract(src, destdir, verbose=false)
31
+ tarinput = new
32
+ Zlib::GzipReader.open(src) do |gz|
33
+ io = StringIO.new gz.read
34
+ Gem::Package::TarReader.new(io) do |tar|
35
+ tar.each do |entry|
36
+ puts "+ #{entry.full_name}" if verbose
37
+ tarinput.extract_entry(destdir, entry)
38
+ end
39
+ end
40
+ end
41
+ end
42
+
43
+ private
44
+
45
+ def initialize
46
+ @fileops = Gem::FileOperations.new
47
+ end
48
+
49
+ end
50
+ end
metadata ADDED
@@ -0,0 +1,85 @@
1
+ --- !ruby/object:Gem::Specification
2
+ name: epublishing-rails-plugin-installer
3
+ version: !ruby/object:Gem::Version
4
+ hash: 41
5
+ prerelease:
6
+ segments:
7
+ - 6
8
+ - 0
9
+ - 3
10
+ version: 6.0.3
11
+ platform: ruby
12
+ authors:
13
+ - David McCullars
14
+ autorequire:
15
+ bindir: bin
16
+ cert_chain: []
17
+
18
+ date: 2011-04-26 00:00:00 -04:00
19
+ default_executable:
20
+ dependencies: []
21
+
22
+ description: An extension of standard rails plugin script to provide support for local file system and tgz files
23
+ email: dmccullars@ePublishing.com
24
+ executables:
25
+ - epub-plugin
26
+ extensions: []
27
+
28
+ extra_rdoc_files:
29
+ - CHANGELOG
30
+ - LICENSE
31
+ - README.rdoc
32
+ - lib/commands/epub-plugin.rb
33
+ files:
34
+ - CHANGELOG
35
+ - LICENSE
36
+ - README.rdoc
37
+ - Rakefile
38
+ - bin/epub-plugin
39
+ - lib/commands/epub-plugin.rb
40
+ - lib/epublishing/tgz_builder.rb
41
+ - lib/epublishing/tgz_extractor.rb
42
+ - Manifest
43
+ - epublishing-rails-plugin-installer.gemspec
44
+ has_rdoc: true
45
+ homepage: http://github.com/ePublishing/epublishing-rails-plugin-installer
46
+ licenses: []
47
+
48
+ post_install_message:
49
+ rdoc_options:
50
+ - --line-numbers
51
+ - --inline-source
52
+ - --title
53
+ - Epublishing-rails-plugin-installer
54
+ - --main
55
+ - README.rdoc
56
+ require_paths:
57
+ - lib
58
+ required_ruby_version: !ruby/object:Gem::Requirement
59
+ none: false
60
+ requirements:
61
+ - - ">="
62
+ - !ruby/object:Gem::Version
63
+ hash: 3
64
+ segments:
65
+ - 0
66
+ version: "0"
67
+ required_rubygems_version: !ruby/object:Gem::Requirement
68
+ none: false
69
+ requirements:
70
+ - - ">="
71
+ - !ruby/object:Gem::Version
72
+ hash: 11
73
+ segments:
74
+ - 1
75
+ - 2
76
+ version: "1.2"
77
+ requirements: []
78
+
79
+ rubyforge_project: epublishing-rails-plugin-installer
80
+ rubygems_version: 1.6.1
81
+ signing_key:
82
+ specification_version: 3
83
+ summary: An extension of standard rails plugin script to provide support for local file system and tgz files
84
+ test_files: []
85
+