buildr-gemjar 1.0.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (252) hide show
  1. data/.braids +8 -0
  2. data/.gitignore +5 -0
  3. data/.rvmrc +1 -0
  4. data/CHANGELOG.md +4 -0
  5. data/Gemfile +4 -0
  6. data/LICENSE +20 -0
  7. data/README.md +98 -0
  8. data/Rakefile +8 -0
  9. data/buildr-gemjar.gemspec +42 -0
  10. data/lib/buildr-gemjar.rb +162 -0
  11. data/lib/buildr-gemjar/version.rb +3 -0
  12. data/meta.rakefile +30 -0
  13. data/spec/buildr-gemjar/version_spec.rb +11 -0
  14. data/spec/buildr-gemjar_spec.rb +179 -0
  15. data/spec/repo_builder.rb +59 -0
  16. data/spec/spec_helper.rb +44 -0
  17. data/vendor/buildr/.gitignore +17 -0
  18. data/vendor/buildr/CHANGELOG +1283 -0
  19. data/vendor/buildr/Gemfile +4 -0
  20. data/vendor/buildr/LICENSE +176 -0
  21. data/vendor/buildr/NOTICE +26 -0
  22. data/vendor/buildr/README.rdoc +134 -0
  23. data/vendor/buildr/Rakefile +44 -0
  24. data/vendor/buildr/_buildr +35 -0
  25. data/vendor/buildr/_jbuildr +35 -0
  26. data/vendor/buildr/addon/buildr/antlr.rb +65 -0
  27. data/vendor/buildr/addon/buildr/bnd.rb +147 -0
  28. data/vendor/buildr/addon/buildr/cobertura.rb +22 -0
  29. data/vendor/buildr/addon/buildr/drb.rb +281 -0
  30. data/vendor/buildr/addon/buildr/emma.rb +22 -0
  31. data/vendor/buildr/addon/buildr/hibernate.rb +149 -0
  32. data/vendor/buildr/addon/buildr/javacc.rb +85 -0
  33. data/vendor/buildr/addon/buildr/jaxb_xjc.rb +72 -0
  34. data/vendor/buildr/addon/buildr/jdepend.rb +60 -0
  35. data/vendor/buildr/addon/buildr/jetty.rb +248 -0
  36. data/vendor/buildr/addon/buildr/jibx.rb +86 -0
  37. data/vendor/buildr/addon/buildr/nailgun.rb +221 -0
  38. data/vendor/buildr/addon/buildr/openjpa.rb +88 -0
  39. data/vendor/buildr/addon/buildr/org/apache/buildr/BuildrNail$Main.class +0 -0
  40. data/vendor/buildr/addon/buildr/org/apache/buildr/BuildrNail.class +0 -0
  41. data/vendor/buildr/addon/buildr/org/apache/buildr/BuildrNail.java +41 -0
  42. data/vendor/buildr/addon/buildr/org/apache/buildr/JettyWrapper$1.class +0 -0
  43. data/vendor/buildr/addon/buildr/org/apache/buildr/JettyWrapper$BuildrHandler.class +0 -0
  44. data/vendor/buildr/addon/buildr/org/apache/buildr/JettyWrapper.class +0 -0
  45. data/vendor/buildr/addon/buildr/org/apache/buildr/JettyWrapper.java +144 -0
  46. data/vendor/buildr/addon/buildr/protobuf.rb +88 -0
  47. data/vendor/buildr/addon/buildr/xmlbeans.rb +93 -0
  48. data/vendor/buildr/all-in-one/_buildr +19 -0
  49. data/vendor/buildr/all-in-one/buildr +368 -0
  50. data/vendor/buildr/all-in-one/buildr.cmd +1 -0
  51. data/vendor/buildr/bin/buildr +19 -0
  52. data/vendor/buildr/buildr.buildfile +58 -0
  53. data/vendor/buildr/buildr.gemspec +74 -0
  54. data/vendor/buildr/doc/_config.yml +1 -0
  55. data/vendor/buildr/doc/_layouts/default.html +90 -0
  56. data/vendor/buildr/doc/_layouts/preface.html +22 -0
  57. data/vendor/buildr/doc/artifacts.textile +217 -0
  58. data/vendor/buildr/doc/building.textile +276 -0
  59. data/vendor/buildr/doc/contributing.textile +268 -0
  60. data/vendor/buildr/doc/css/default.css +236 -0
  61. data/vendor/buildr/doc/css/print.css +101 -0
  62. data/vendor/buildr/doc/css/syntax.css +23 -0
  63. data/vendor/buildr/doc/download.textile +138 -0
  64. data/vendor/buildr/doc/extending.textile +212 -0
  65. data/vendor/buildr/doc/images/1442160941-frontcover.jpg +0 -0
  66. data/vendor/buildr/doc/images/asf-logo.gif +0 -0
  67. data/vendor/buildr/doc/images/asf-logo.png +0 -0
  68. data/vendor/buildr/doc/images/buildr-hires.png +0 -0
  69. data/vendor/buildr/doc/images/buildr.png +0 -0
  70. data/vendor/buildr/doc/images/favicon.png +0 -0
  71. data/vendor/buildr/doc/images/growl-icon.tiff +0 -0
  72. data/vendor/buildr/doc/images/note.png +0 -0
  73. data/vendor/buildr/doc/images/project-structure.png +0 -0
  74. data/vendor/buildr/doc/images/tip.png +0 -0
  75. data/vendor/buildr/doc/images/zbuildr.png +0 -0
  76. data/vendor/buildr/doc/images/zbuildr.tif +0 -0
  77. data/vendor/buildr/doc/index.textile +69 -0
  78. data/vendor/buildr/doc/installing.textile +284 -0
  79. data/vendor/buildr/doc/languages.textile +599 -0
  80. data/vendor/buildr/doc/mailing_lists.textile +29 -0
  81. data/vendor/buildr/doc/more_stuff.textile +845 -0
  82. data/vendor/buildr/doc/packaging.textile +618 -0
  83. data/vendor/buildr/doc/preface.textile +54 -0
  84. data/vendor/buildr/doc/projects.textile +276 -0
  85. data/vendor/buildr/doc/quick_start.textile +210 -0
  86. data/vendor/buildr/doc/releasing.textile +117 -0
  87. data/vendor/buildr/doc/scripts/buildr-git.rb +512 -0
  88. data/vendor/buildr/doc/scripts/gitflow.rb +296 -0
  89. data/vendor/buildr/doc/scripts/install-jruby.sh +44 -0
  90. data/vendor/buildr/doc/scripts/install-linux.sh +73 -0
  91. data/vendor/buildr/doc/scripts/install-osx.sh +52 -0
  92. data/vendor/buildr/doc/settings_profiles.textile +287 -0
  93. data/vendor/buildr/doc/testing.textile +247 -0
  94. data/vendor/buildr/etc/KEYS +189 -0
  95. data/vendor/buildr/lib/buildr.rb +44 -0
  96. data/vendor/buildr/lib/buildr/clojure.rb +34 -0
  97. data/vendor/buildr/lib/buildr/clojure/shell.rb +52 -0
  98. data/vendor/buildr/lib/buildr/core.rb +34 -0
  99. data/vendor/buildr/lib/buildr/core/application.rb +700 -0
  100. data/vendor/buildr/lib/buildr/core/build.rb +516 -0
  101. data/vendor/buildr/lib/buildr/core/cc.rb +166 -0
  102. data/vendor/buildr/lib/buildr/core/checks.rb +253 -0
  103. data/vendor/buildr/lib/buildr/core/common.rb +151 -0
  104. data/vendor/buildr/lib/buildr/core/compile.rb +622 -0
  105. data/vendor/buildr/lib/buildr/core/doc.rb +276 -0
  106. data/vendor/buildr/lib/buildr/core/environment.rb +129 -0
  107. data/vendor/buildr/lib/buildr/core/filter.rb +404 -0
  108. data/vendor/buildr/lib/buildr/core/generate.rb +197 -0
  109. data/vendor/buildr/lib/buildr/core/help.rb +119 -0
  110. data/vendor/buildr/lib/buildr/core/jrebel.rb +42 -0
  111. data/vendor/buildr/lib/buildr/core/linux.rb +30 -0
  112. data/vendor/buildr/lib/buildr/core/osx.rb +46 -0
  113. data/vendor/buildr/lib/buildr/core/progressbar.rb +161 -0
  114. data/vendor/buildr/lib/buildr/core/project.rb +975 -0
  115. data/vendor/buildr/lib/buildr/core/run.rb +43 -0
  116. data/vendor/buildr/lib/buildr/core/shell.rb +137 -0
  117. data/vendor/buildr/lib/buildr/core/test.rb +843 -0
  118. data/vendor/buildr/lib/buildr/core/transports.rb +565 -0
  119. data/vendor/buildr/lib/buildr/core/util.rb +537 -0
  120. data/vendor/buildr/lib/buildr/groovy.rb +20 -0
  121. data/vendor/buildr/lib/buildr/groovy/bdd.rb +106 -0
  122. data/vendor/buildr/lib/buildr/groovy/compiler.rb +153 -0
  123. data/vendor/buildr/lib/buildr/groovy/doc.rb +76 -0
  124. data/vendor/buildr/lib/buildr/groovy/shell.rb +57 -0
  125. data/vendor/buildr/lib/buildr/ide.rb +19 -0
  126. data/vendor/buildr/lib/buildr/ide/eclipse.rb +427 -0
  127. data/vendor/buildr/lib/buildr/ide/eclipse/java.rb +53 -0
  128. data/vendor/buildr/lib/buildr/ide/eclipse/plugin.rb +71 -0
  129. data/vendor/buildr/lib/buildr/ide/eclipse/scala.rb +68 -0
  130. data/vendor/buildr/lib/buildr/ide/idea.rb +576 -0
  131. data/vendor/buildr/lib/buildr/java.rb +25 -0
  132. data/vendor/buildr/lib/buildr/java/ant.rb +94 -0
  133. data/vendor/buildr/lib/buildr/java/bdd.rb +460 -0
  134. data/vendor/buildr/lib/buildr/java/cobertura.rb +297 -0
  135. data/vendor/buildr/lib/buildr/java/commands.rb +223 -0
  136. data/vendor/buildr/lib/buildr/java/compiler.rb +135 -0
  137. data/vendor/buildr/lib/buildr/java/deprecated.rb +141 -0
  138. data/vendor/buildr/lib/buildr/java/doc.rb +86 -0
  139. data/vendor/buildr/lib/buildr/java/ecj.rb +69 -0
  140. data/vendor/buildr/lib/buildr/java/emma.rb +244 -0
  141. data/vendor/buildr/lib/buildr/java/external.rb +73 -0
  142. data/vendor/buildr/lib/buildr/java/jruby.rb +122 -0
  143. data/vendor/buildr/lib/buildr/java/jtestr_result.rb +295 -0
  144. data/vendor/buildr/lib/buildr/java/jtestr_runner.rb.erb +116 -0
  145. data/vendor/buildr/lib/buildr/java/org/apache/buildr/JavaTestFilter.class +0 -0
  146. data/vendor/buildr/lib/buildr/java/org/apache/buildr/JavaTestFilter.java +142 -0
  147. data/vendor/buildr/lib/buildr/java/packaging.rb +734 -0
  148. data/vendor/buildr/lib/buildr/java/pom.rb +178 -0
  149. data/vendor/buildr/lib/buildr/java/rjb.rb +154 -0
  150. data/vendor/buildr/lib/buildr/java/test_result.rb +101 -0
  151. data/vendor/buildr/lib/buildr/java/tests.rb +362 -0
  152. data/vendor/buildr/lib/buildr/java/version_requirement.rb +172 -0
  153. data/vendor/buildr/lib/buildr/packaging.rb +25 -0
  154. data/vendor/buildr/lib/buildr/packaging/archive.rb +535 -0
  155. data/vendor/buildr/lib/buildr/packaging/artifact.rb +903 -0
  156. data/vendor/buildr/lib/buildr/packaging/artifact_namespace.rb +984 -0
  157. data/vendor/buildr/lib/buildr/packaging/artifact_search.rb +140 -0
  158. data/vendor/buildr/lib/buildr/packaging/gems.rb +105 -0
  159. data/vendor/buildr/lib/buildr/packaging/package.rb +249 -0
  160. data/vendor/buildr/lib/buildr/packaging/tar.rb +189 -0
  161. data/vendor/buildr/lib/buildr/packaging/version_requirement.rb +192 -0
  162. data/vendor/buildr/lib/buildr/packaging/zip.rb +178 -0
  163. data/vendor/buildr/lib/buildr/packaging/ziptask.rb +356 -0
  164. data/vendor/buildr/lib/buildr/resources/buildr.icns +0 -0
  165. data/vendor/buildr/lib/buildr/resources/completed.png +0 -0
  166. data/vendor/buildr/lib/buildr/resources/failed.png +0 -0
  167. data/vendor/buildr/lib/buildr/resources/icons-license.txt +17 -0
  168. data/vendor/buildr/lib/buildr/run.rb +195 -0
  169. data/vendor/buildr/lib/buildr/scala.rb +26 -0
  170. data/vendor/buildr/lib/buildr/scala/bdd.rb +118 -0
  171. data/vendor/buildr/lib/buildr/scala/compiler.rb +242 -0
  172. data/vendor/buildr/lib/buildr/scala/doc.rb +142 -0
  173. data/vendor/buildr/lib/buildr/scala/org/apache/buildr/SpecsSingletonRunner.class +0 -0
  174. data/vendor/buildr/lib/buildr/scala/org/apache/buildr/SpecsSingletonRunner.java +57 -0
  175. data/vendor/buildr/lib/buildr/scala/shell.rb +52 -0
  176. data/vendor/buildr/lib/buildr/scala/tests.rb +171 -0
  177. data/vendor/buildr/lib/buildr/shell.rb +185 -0
  178. data/vendor/buildr/lib/buildr/version.rb +18 -0
  179. data/vendor/buildr/rakelib/all-in-one.rake +113 -0
  180. data/vendor/buildr/rakelib/checks.rake +57 -0
  181. data/vendor/buildr/rakelib/doc.rake +137 -0
  182. data/vendor/buildr/rakelib/metrics.rake +39 -0
  183. data/vendor/buildr/rakelib/package.rake +73 -0
  184. data/vendor/buildr/rakelib/release.rake +161 -0
  185. data/vendor/buildr/rakelib/rspec.rake +101 -0
  186. data/vendor/buildr/rakelib/setup.rake +66 -0
  187. data/vendor/buildr/rakelib/stage.rake +220 -0
  188. data/vendor/buildr/spec/addon/bnd_spec.rb +330 -0
  189. data/vendor/buildr/spec/addon/drb_spec.rb +328 -0
  190. data/vendor/buildr/spec/addon/jaxb_xjc_spec.rb +125 -0
  191. data/vendor/buildr/spec/core/application_spec.rb +631 -0
  192. data/vendor/buildr/spec/core/build_spec.rb +837 -0
  193. data/vendor/buildr/spec/core/cc_spec.rb +224 -0
  194. data/vendor/buildr/spec/core/checks_spec.rb +519 -0
  195. data/vendor/buildr/spec/core/common_spec.rb +725 -0
  196. data/vendor/buildr/spec/core/compile_spec.rb +658 -0
  197. data/vendor/buildr/spec/core/doc_spec.rb +195 -0
  198. data/vendor/buildr/spec/core/extension_spec.rb +201 -0
  199. data/vendor/buildr/spec/core/generate_spec.rb +33 -0
  200. data/vendor/buildr/spec/core/project_spec.rb +772 -0
  201. data/vendor/buildr/spec/core/run_spec.rb +93 -0
  202. data/vendor/buildr/spec/core/shell_spec.rb +146 -0
  203. data/vendor/buildr/spec/core/test_spec.rb +1320 -0
  204. data/vendor/buildr/spec/core/transport_spec.rb +544 -0
  205. data/vendor/buildr/spec/core/util_spec.rb +141 -0
  206. data/vendor/buildr/spec/groovy/bdd_spec.rb +80 -0
  207. data/vendor/buildr/spec/groovy/compiler_spec.rb +251 -0
  208. data/vendor/buildr/spec/groovy/doc_spec.rb +65 -0
  209. data/vendor/buildr/spec/ide/eclipse_spec.rb +739 -0
  210. data/vendor/buildr/spec/ide/idea_spec.rb +1144 -0
  211. data/vendor/buildr/spec/java/ant_spec.rb +37 -0
  212. data/vendor/buildr/spec/java/bdd_spec.rb +374 -0
  213. data/vendor/buildr/spec/java/cobertura_spec.rb +112 -0
  214. data/vendor/buildr/spec/java/commands_spec.rb +93 -0
  215. data/vendor/buildr/spec/java/compiler_spec.rb +252 -0
  216. data/vendor/buildr/spec/java/doc_spec.rb +56 -0
  217. data/vendor/buildr/spec/java/ecj_spec.rb +115 -0
  218. data/vendor/buildr/spec/java/emma_spec.rb +121 -0
  219. data/vendor/buildr/spec/java/external_spec.rb +56 -0
  220. data/vendor/buildr/spec/java/java_spec.rb +132 -0
  221. data/vendor/buildr/spec/java/packaging_spec.rb +1270 -0
  222. data/vendor/buildr/spec/java/run_spec.rb +78 -0
  223. data/vendor/buildr/spec/java/test_coverage_helper.rb +257 -0
  224. data/vendor/buildr/spec/java/tests_spec.rb +497 -0
  225. data/vendor/buildr/spec/packaging/archive_spec.rb +775 -0
  226. data/vendor/buildr/spec/packaging/artifact_namespace_spec.rb +743 -0
  227. data/vendor/buildr/spec/packaging/artifact_spec.rb +1066 -0
  228. data/vendor/buildr/spec/packaging/packaging_helper.rb +63 -0
  229. data/vendor/buildr/spec/packaging/packaging_spec.rb +719 -0
  230. data/vendor/buildr/spec/sandbox.rb +165 -0
  231. data/vendor/buildr/spec/scala/bdd_spec.rb +124 -0
  232. data/vendor/buildr/spec/scala/compiler_spec.rb +289 -0
  233. data/vendor/buildr/spec/scala/doc_spec.rb +88 -0
  234. data/vendor/buildr/spec/scala/scala.rb +38 -0
  235. data/vendor/buildr/spec/scala/tests_spec.rb +283 -0
  236. data/vendor/buildr/spec/spec_helpers.rb +369 -0
  237. data/vendor/buildr/spec/version_requirement_spec.rb +143 -0
  238. data/vendor/buildr/spec/xpath_matchers.rb +121 -0
  239. data/vendor/buildr/tests/BUILDR-320/Buildfile +29 -0
  240. data/vendor/buildr/tests/JavaSystemProperty/Buildfile +18 -0
  241. data/vendor/buildr/tests/JavaSystemProperty/src/test/java/FooTest.java +24 -0
  242. data/vendor/buildr/tests/compile_with_parent/Buildfile +18 -0
  243. data/vendor/buildr/tests/compile_with_parent/child/src/main/java/Foo.java +23 -0
  244. data/vendor/buildr/tests/helloWorld/Buildfile +20 -0
  245. data/vendor/buildr/tests/helloWorld/src/main/java/HelloWorld.java +23 -0
  246. data/vendor/buildr/tests/integration_testing.rb +56 -0
  247. data/vendor/buildr/tests/junit3/Buildfile +9 -0
  248. data/vendor/buildr/tests/junit3/src/main/java/Foo.java +23 -0
  249. data/vendor/buildr/tests/junit3/src/test/java/FooTest.java +28 -0
  250. data/vendor/buildr/tests/package_war_as_jar/Buildfile +15 -0
  251. data/vendor/buildr/tests/package_war_as_jar/src/main/java/Foo.java +19 -0
  252. metadata +524 -0
@@ -0,0 +1,565 @@
1
+ # Licensed to the Apache Software Foundation (ASF) under one or more
2
+ # contributor license agreements. See the NOTICE file distributed with this
3
+ # work for additional information regarding copyright ownership. The ASF
4
+ # licenses this file to you under the Apache License, Version 2.0 (the
5
+ # "License"); you may not use this file except in compliance with the License.
6
+ # You may obtain a copy of the License at
7
+ #
8
+ # http://www.apache.org/licenses/LICENSE-2.0
9
+ #
10
+ # Unless required by applicable law or agreed to in writing, software
11
+ # distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
12
+ # WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
13
+ # License for the specific language governing permissions and limitations under
14
+ # the License.
15
+
16
+
17
+ require 'uri'
18
+ require 'net/http'
19
+ # PATCH: On Windows, Net::SSH 2.0.2 attempts to load the Pageant DLLs which break on JRuby.
20
+ $LOADED_FEATURES << 'net/ssh/authentication/pageant.rb' if RUBY_PLATFORM =~ /java/
21
+ gem 'net-ssh' ; Net.autoload :SSH, 'net/ssh'
22
+ gem 'net-sftp' ; Net.autoload :SFTP, 'net/sftp'
23
+ autoload :CGI, 'cgi'
24
+ require 'digest/md5'
25
+ require 'digest/sha1'
26
+ require 'stringio'
27
+ autoload :ProgressBar, 'buildr/core/progressbar'
28
+
29
+
30
+ # Not quite open-uri, but similar. Provides read and write methods for the resource represented by the URI.
31
+ # Currently supports reads for URI::HTTP and writes for URI::SFTP. Also provides convenience methods for
32
+ # downloads and uploads.
33
+ module URI
34
+
35
+ # Raised when trying to read/download a resource that doesn't exist.
36
+ class NotFoundError < RuntimeError
37
+ end
38
+
39
+ # How many bytes to read/write at once. Do not change without checking BUILDR-214 first.
40
+ RW_CHUNK_SIZE = 128 * 1024 #:nodoc:
41
+
42
+ class << self
43
+
44
+ # :call-seq:
45
+ # read(uri, options?) => content
46
+ # read(uri, options?) { |chunk| ... }
47
+ #
48
+ # Reads from the resource behind this URI. The first form returns the content of the resource,
49
+ # the second form yields to the block with each chunk of content (usually more than one).
50
+ #
51
+ # For example:
52
+ # File.open 'image.jpg', 'w' do |file|
53
+ # URI.read('http://example.com/image.jpg') { |chunk| file.write chunk }
54
+ # end
55
+ # Shorter version:
56
+ # File.open('image.jpg', 'w') { |file| file.write URI.read('http://example.com/image.jpg') }
57
+ #
58
+ # Supported options:
59
+ # * :modified -- Only download if file modified since this timestamp. Returns nil if not modified.
60
+ # * :progress -- Show the progress bar while reading.
61
+ def read(uri, options = nil, &block)
62
+ uri = URI.parse(uri.to_s) unless URI === uri
63
+ uri.read options, &block
64
+ end
65
+
66
+ # :call-seq:
67
+ # download(uri, target, options?)
68
+ #
69
+ # Downloads the resource to the target.
70
+ #
71
+ # The target may be a file name (string or task), in which case the file is created from the resource.
72
+ # The target may also be any object that responds to +write+, e.g. File, StringIO, Pipe.
73
+ #
74
+ # Use the progress bar when running in verbose mode.
75
+ def download(uri, target, options = nil)
76
+ uri = URI.parse(uri.to_s) unless URI === uri
77
+ uri.download target, options
78
+ end
79
+
80
+ # :call-seq:
81
+ # write(uri, content, options?)
82
+ # write(uri, options?) { |bytes| .. }
83
+ #
84
+ # Writes to the resource behind the URI. The first form writes the content from a string or an object
85
+ # that responds to +read+ and optionally +size+. The second form writes the content by yielding to the
86
+ # block. Each yield should return up to the specified number of bytes, the last yield returns nil.
87
+ #
88
+ # For example:
89
+ # File.open 'killer-app.jar', 'rb' do |file|
90
+ # write('sftp://localhost/jars/killer-app.jar') { |chunk| file.read(chunk) }
91
+ # end
92
+ # Or:
93
+ # write 'sftp://localhost/jars/killer-app.jar', File.read('killer-app.jar')
94
+ #
95
+ # Supported options:
96
+ # * :progress -- Show the progress bar while reading.
97
+ def write(uri, *args, &block)
98
+ uri = URI.parse(uri.to_s) unless URI === uri
99
+ uri.write *args, &block
100
+ end
101
+
102
+ # :call-seq:
103
+ # upload(uri, source, options?)
104
+ #
105
+ # Uploads from source to the resource.
106
+ #
107
+ # The source may be a file name (string or task), in which case the file is uploaded to the resource.
108
+ # The source may also be any object that responds to +read+ (and optionally +size+), e.g. File, StringIO, Pipe.
109
+ #
110
+ # Use the progress bar when running in verbose mode.
111
+ def upload(uri, source, options = nil)
112
+ uri = URI.parse(uri.to_s) unless URI === uri
113
+ uri.upload source, options
114
+ end
115
+
116
+ end
117
+
118
+ class Generic
119
+
120
+ # :call-seq:
121
+ # read(options?) => content
122
+ # read(options?) { |chunk| ... }
123
+ #
124
+ # Reads from the resource behind this URI. The first form returns the content of the resource,
125
+ # the second form yields to the block with each chunk of content (usually more than one).
126
+ #
127
+ # For options, see URI::read.
128
+ def read(options = nil, &block)
129
+ fail 'This protocol doesn\'t support reading (yet, how about helping by implementing it?)'
130
+ end
131
+
132
+ # :call-seq:
133
+ # download(target, options?)
134
+ #
135
+ # Downloads the resource to the target.
136
+ #
137
+ # The target may be a file name (string or task), in which case the file is created from the resource.
138
+ # The target may also be any object that responds to +write+, e.g. File, StringIO, Pipe.
139
+ #
140
+ # Use the progress bar when running in verbose mode.
141
+ def download(target, options = nil)
142
+ case target
143
+ when Rake::Task
144
+ download target.name, options
145
+ when String
146
+ # If download breaks we end up with a partial file which is
147
+ # worse than not having a file at all, so download to temporary
148
+ # file and then move over.
149
+ modified = File.stat(target).mtime if File.exist?(target)
150
+ temp = Tempfile.new(File.basename(target))
151
+ temp.binmode
152
+ read({:progress=>verbose}.merge(options || {}).merge(:modified=>modified)) { |chunk| temp.write chunk }
153
+ temp.close
154
+ mkpath File.dirname(target)
155
+ mv temp.path, target
156
+ when File
157
+ read({:progress=>verbose}.merge(options || {}).merge(:modified=>target.mtime)) { |chunk| target.write chunk }
158
+ target.flush
159
+ else
160
+ raise ArgumentError, 'Expecting a target that is either a file name (string, task) or object that responds to write (file, pipe).' unless target.respond_to?(:write)
161
+ read({:progress=>verbose}.merge(options || {})) { |chunk| target.write chunk }
162
+ target.flush
163
+ end
164
+ end
165
+
166
+ # :call-seq:
167
+ # write(content, options?)
168
+ # write(options?) { |bytes| .. }
169
+ #
170
+ # Writes to the resource behind the URI. The first form writes the content from a string or an object
171
+ # that responds to +read+ and optionally +size+. The second form writes the content by yielding to the
172
+ # block. Each yield should return up to the specified number of bytes, the last yield returns nil.
173
+ #
174
+ # For options, see URI::write.
175
+ def write(*args, &block)
176
+ options = args.pop if Hash === args.last
177
+ options ||= {}
178
+ if String === args.first
179
+ ios = StringIO.new(args.first, 'r')
180
+ write(options.merge(:size=>args.first.size)) { |bytes| ios.read(bytes) }
181
+ elsif args.first.respond_to?(:read)
182
+ size = args.first.size rescue nil
183
+ write({:size=>size}.merge(options)) { |bytes| args.first.read(bytes) }
184
+ elsif args.empty? && block
185
+ write_internal options, &block
186
+ else
187
+ raise ArgumentError, 'Either give me the content, or pass me a block, otherwise what would I upload?'
188
+ end
189
+ end
190
+
191
+ # :call-seq:
192
+ # upload(source, options?)
193
+ #
194
+ # Uploads from source to the resource.
195
+ #
196
+ # The source may be a file name (string or task), in which case the file is uploaded to the resource.
197
+ # If the source is a directory, uploads all files inside the directory (including nested directories).
198
+ # The source may also be any object that responds to +read+ (and optionally +size+), e.g. File, StringIO, Pipe.
199
+ #
200
+ # Use the progress bar when running in verbose mode.
201
+ def upload(source, options = nil)
202
+ source = source.name if Rake::Task === source
203
+ options ||= {}
204
+ if String === source
205
+ raise NotFoundError, 'No source file/directory to upload.' unless File.exist?(source)
206
+ if File.directory?(source)
207
+ Dir.glob("#{source}/**/*").reject { |file| File.directory?(file) }.each do |file|
208
+ uri = self + (File.join(self.path, file.sub(source, '')))
209
+ uri.upload file, {:digests=>[]}.merge(options)
210
+ end
211
+ else
212
+ File.open(source, 'rb') { |input| upload input, options }
213
+ end
214
+ elsif source.respond_to?(:read)
215
+ digests = (options[:digests] || [:md5, :sha1]).
216
+ inject({}) { |hash, name| hash[name] = Digest.const_get(name.to_s.upcase).new ; hash }
217
+ size = source.stat.size rescue nil
218
+ write (options).merge(:progress=>verbose && size, :size=>size) do |bytes|
219
+ source.read(bytes).tap do |chunk|
220
+ digests.values.each { |digest| digest << chunk } if chunk
221
+ end
222
+ end
223
+ digests.each do |key, digest|
224
+ self.merge("#{self.path}.#{key}").write digest.hexdigest,
225
+ (options).merge(:progress=>false)
226
+ end
227
+ else
228
+ raise ArgumentError, 'Expecting source to be a file name (string, task) or any object that responds to read (file, pipe).'
229
+ end
230
+ end
231
+
232
+ protected
233
+
234
+ # :call-seq:
235
+ # with_progress_bar(show, file_name, size) { |progress| ... }
236
+ #
237
+ # Displays a progress bar while executing the block. The first argument must be true for the
238
+ # progress bar to show (TTY output also required), as a convenient for selectively using the
239
+ # progress bar from a single block.
240
+ #
241
+ # The second argument provides a filename to display, the third its size in bytes.
242
+ #
243
+ # The block is yielded with a progress object that implements a single method.
244
+ # Call << for each block of bytes down/uploaded.
245
+ def with_progress_bar(show, file_name, size, &block) #:nodoc:
246
+ options = { :total=>size || 0, :title=>file_name }
247
+ options[:hidden] = true unless show
248
+ ProgressBar.start options, &block
249
+ end
250
+
251
+ # :call-seq:
252
+ # proxy_uri => URI?
253
+ #
254
+ # Returns the proxy server to use. Obtains the proxy from the relevant environment variable (e.g. HTTP_PROXY).
255
+ # Supports exclusions based on host name and port number from environment variable NO_PROXY.
256
+ def proxy_uri
257
+ proxy = ENV["#{scheme.upcase}_PROXY"]
258
+ proxy = URI.parse(proxy) if String === proxy
259
+ excludes = ENV['NO_PROXY'].to_s.split(/\s*,\s*/).compact
260
+ excludes = excludes.map { |exclude| exclude =~ /:\d+$/ ? exclude : "#{exclude}:*" }
261
+ return proxy unless excludes.any? { |exclude| File.fnmatch(exclude, "#{host}:#{port}") }
262
+ end
263
+
264
+ def write_internal(options, &block) #:nodoc:
265
+ fail 'This protocol doesn\'t support writing (yet, how about helping by implementing it?)'
266
+ end
267
+
268
+ end
269
+
270
+
271
+ class HTTP #:nodoc:
272
+
273
+ # See URI::Generic#read
274
+ def read(options = nil, &block)
275
+ options ||= {}
276
+ connect do |http|
277
+ trace "Requesting #{self}"
278
+ headers = { 'If-Modified-Since' => CGI.rfc1123_date(options[:modified].utc) } if options[:modified]
279
+ request = Net::HTTP::Get.new(request_uri.empty? ? '/' : request_uri, headers)
280
+ request.basic_auth self.user, self.password if self.user
281
+ http.request request do |response|
282
+ case response
283
+ when Net::HTTPNotModified
284
+ # No modification, nothing to do.
285
+ trace 'Not modified since last download'
286
+ return nil
287
+ when Net::HTTPRedirection
288
+ # Try to download from the new URI, handle relative redirects.
289
+ trace "Redirected to #{response['Location']}"
290
+ rself = self + URI.parse(response['Location'])
291
+ rself.user, rself.password = self.user, self.password
292
+ return rself.read(options, &block)
293
+ when Net::HTTPOK
294
+ info "Downloading #{self}"
295
+ result = nil
296
+ with_progress_bar options[:progress], path.split('/').last, response.content_length do |progress|
297
+ if block
298
+ response.read_body do |chunk|
299
+ block.call chunk
300
+ progress << chunk
301
+ end
302
+ else
303
+ result = ''
304
+ response.read_body do |chunk|
305
+ result << chunk
306
+ progress << chunk
307
+ end
308
+ end
309
+ end
310
+ return result
311
+ when Net::HTTPNotFound
312
+ raise NotFoundError, "Looking for #{self} and all I got was a 404!"
313
+ else
314
+ raise RuntimeError, "Failed to download #{self}: #{response.message}"
315
+ end
316
+ end
317
+ end
318
+ end
319
+
320
+ private
321
+
322
+ def write_internal(options, &block) #:nodoc:
323
+ options ||= {}
324
+ connect do |http|
325
+ trace "Uploading to #{path}"
326
+ content = StringIO.new
327
+ while chunk = yield(RW_CHUNK_SIZE)
328
+ content << chunk
329
+ end
330
+ headers = { 'Content-MD5'=>Digest::MD5.hexdigest(content.string) }
331
+ request = Net::HTTP::Put.new(request_uri.empty? ? '/' : request_uri, headers)
332
+ request.basic_auth self.user, self.password if self.user
333
+ response = nil
334
+ with_progress_bar options[:progress], path.split('/').last, content.size do |progress|
335
+ request.content_length = content.size
336
+ content.rewind
337
+ stream = Object.new
338
+ class << stream ; self ;end.send :define_method, :read do |count|
339
+ bytes = content.read(count)
340
+ progress << bytes if bytes
341
+ bytes
342
+ end
343
+ request.body_stream = stream
344
+ response = http.request(request)
345
+ end
346
+
347
+ case response
348
+ when Net::HTTPRedirection
349
+ # Try to download from the new URI, handle relative redirects.
350
+ trace "Redirected to #{response['Location']}"
351
+ content.rewind
352
+ return (self + URI.parse(response['location'])).write_internal(options) { |bytes| content.read(bytes) }
353
+ when Net::HTTPSuccess
354
+ else
355
+ raise RuntimeError, "Failed to upload #{self}: #{response.message}"
356
+ end
357
+ end
358
+ end
359
+
360
+ def connect
361
+ if proxy = proxy_uri
362
+ proxy = URI.parse(proxy) if String === proxy
363
+ http = Net::HTTP.new(host, port, proxy.host, proxy.port, proxy.user, proxy.password)
364
+ else
365
+ http = Net::HTTP.new(host, port)
366
+ end
367
+ if self.instance_of? URI::HTTPS
368
+ require 'net/https'
369
+ http.use_ssl = true
370
+ end
371
+ yield http
372
+ end
373
+
374
+ end
375
+
376
+
377
+ class SFTP < Generic #:nodoc:
378
+
379
+ DEFAULT_PORT = 22
380
+ COMPONENT = [ :scheme, :userinfo, :host, :port, :path ].freeze
381
+
382
+ class << self
383
+ # Caching of passwords, so we only need to ask once.
384
+ def passwords
385
+ @passwords ||= {}
386
+ end
387
+ end
388
+
389
+ def initialize(*arg)
390
+ super
391
+ end
392
+
393
+ def read(options = {}, &block)
394
+ # SSH options are based on the username/password from the URI.
395
+ ssh_options = { :port=>port, :password=>password }.merge(options[:ssh_options] || {})
396
+ ssh_options[:password] ||= SFTP.passwords[host]
397
+ begin
398
+ trace "Connecting to #{host}"
399
+ if block
400
+ result = nil
401
+ else
402
+ result = ''
403
+ block = lambda { |chunk| result << chunk }
404
+ end
405
+ Net::SFTP.start(host, user, ssh_options) do |sftp|
406
+ SFTP.passwords[host] = ssh_options[:password]
407
+ trace 'connected'
408
+
409
+ with_progress_bar options[:progress] && options[:size], path.split('/').last, options[:size] || 0 do |progress|
410
+ trace "Downloading from #{path}"
411
+ sftp.file.open(path, 'r') do |file|
412
+ while chunk = file.read(RW_CHUNK_SIZE)
413
+ block.call chunk
414
+ progress << chunk
415
+ break if chunk.size < RW_CHUNK_SIZE
416
+ end
417
+ end
418
+ end
419
+ end
420
+ return result
421
+ rescue Net::SSH::AuthenticationFailed=>ex
422
+ # Only if running with console, prompt for password.
423
+ if !ssh_options[:password] && $stdout.isatty
424
+ password = ask("Password for #{host}:") { |q| q.echo = '*' }
425
+ ssh_options[:password] = password
426
+ retry
427
+ end
428
+ raise
429
+ end
430
+ end
431
+
432
+ protected
433
+
434
+ def write_internal(options, &block) #:nodoc:
435
+ # SSH options are based on the username/password from the URI.
436
+ ssh_options = { :port=>port, :password=>password }.merge(options[:ssh_options] || {})
437
+ ssh_options[:password] ||= SFTP.passwords[host]
438
+ begin
439
+ trace "Connecting to #{host}"
440
+ Net::SFTP.start(host, user, ssh_options) do |sftp|
441
+ SFTP.passwords[host] = ssh_options[:password]
442
+ trace 'Connected'
443
+
444
+ # To create a path, we need to create all its parent. We use realpath to determine if
445
+ # the path already exists, otherwise mkdir fails.
446
+ trace "Creating path #{path}"
447
+ File.dirname(path).split('/').reject(&:empty?).inject('/') do |base, part|
448
+ combined = base + part
449
+ sftp.close(sftp.opendir!(combined)) rescue sftp.mkdir! combined, {}
450
+ "#{combined}/"
451
+ end
452
+
453
+ with_progress_bar options[:progress] && options[:size], path.split('/').last, options[:size] || 0 do |progress|
454
+ trace "Uploading to #{path}"
455
+ sftp.file.open(path, 'w') do |file|
456
+ while chunk = yield(RW_CHUNK_SIZE)
457
+ file.write chunk
458
+ progress << chunk
459
+ end
460
+ sftp.setstat(path, :permissions => options[:permissions]) if options[:permissions]
461
+ end
462
+ end
463
+ end
464
+ rescue Net::SSH::AuthenticationFailed=>ex
465
+ # Only if running with console, prompt for password.
466
+ if !ssh_options[:password] && $stdout.isatty
467
+ password = ask("Password for #{host}:") { |q| q.echo = '*' }
468
+ ssh_options[:password] = password
469
+ retry
470
+ end
471
+ raise
472
+ end
473
+ end
474
+
475
+ end
476
+
477
+ @@schemes['SFTP'] = SFTP
478
+
479
+
480
+ # File URL. Keep in mind that file URLs take the form of <code>file://host/path</code>, although the host
481
+ # is not used, so typically all you will see are three backslashes. This methods accept common variants,
482
+ # like <code>file:/path</code> but always returns a valid URL.
483
+ class FILE < Generic
484
+
485
+ COMPONENT = [ :host, :path ].freeze
486
+
487
+ def upload(source, options = nil)
488
+ super
489
+ if File === source then
490
+ File.chmod(source.stat.mode, real_path)
491
+ end
492
+ end
493
+
494
+ def initialize(*args)
495
+ super
496
+ # file:something (opaque) becomes file:///something
497
+ if path.nil?
498
+ set_path "/#{opaque}"
499
+ unless opaque.nil?
500
+ set_opaque nil
501
+ warn "#{caller[2]}: We'll accept this URL, but just so you know, it needs three slashes, as in: #{to_s}"
502
+ end
503
+ end
504
+ # Sadly, file://something really means file://something/ (something being server)
505
+ set_path '/' if path.empty?
506
+
507
+ # On windows, file://c:/something is not a valid URL, but people do it anyway, so if we see a drive-as-host,
508
+ # we'll just be nice enough to fix it. (URI actually strips the colon here)
509
+ if host =~ /^[a-zA-Z]$/
510
+ set_path "/#{host}:#{path}"
511
+ set_host nil
512
+ end
513
+ end
514
+
515
+ # See URI::Generic#read
516
+ def read(options = nil, &block)
517
+ options ||= {}
518
+ raise ArgumentError, 'Either you\'re attempting to read a file from another host (which we don\'t support), or you used two slashes by mistake, where you should have file:///<path>.' if host
519
+
520
+ path = real_path
521
+ # TODO: complain about clunky URLs
522
+ raise NotFoundError, "Looking for #{self} and can't find it." unless File.exists?(path)
523
+ raise NotFoundError, "Looking for the file #{self}, and it happens to be a directory." if File.directory?(path)
524
+ File.open path, 'rb' do |input|
525
+ with_progress_bar options[:progress], path.split('/').last, input.stat.size do |progress|
526
+ block ? block.call(input.read) : input.read
527
+ end
528
+ end
529
+ end
530
+
531
+ def to_s
532
+ "file://#{host}#{path}"
533
+ end
534
+
535
+ # Returns the file system path based that corresponds to the URL path.
536
+ # On windows this method strips the leading slash off of the path.
537
+ # On all platforms this method unescapes the URL path.
538
+ def real_path #:nodoc:
539
+ real_path = Buildr::Util.win_os? && path =~ /^\/[a-zA-Z]:\// ? path[1..-1] : path
540
+ URI.unescape(real_path)
541
+ end
542
+
543
+ protected
544
+
545
+ def write_internal(options, &block) #:nodoc:
546
+ raise ArgumentError, 'Either you\'re attempting to write a file to another host (which we don\'t support), or you used two slashes by mistake, where you should have file:///<path>.' if host
547
+ temp = Tempfile.new(File.basename(path))
548
+ temp.binmode
549
+ with_progress_bar options[:progress] && options[:size], path.split('/').last, options[:size] || 0 do |progress|
550
+ while chunk = yield(RW_CHUNK_SIZE)
551
+ temp.write chunk
552
+ progress << chunk
553
+ end
554
+ end
555
+ temp.close
556
+ mkpath File.dirname(real_path)
557
+ mv temp.path, real_path
558
+ real_path
559
+ end
560
+
561
+ @@schemes['FILE'] = FILE
562
+
563
+ end
564
+
565
+ end