UrgentcareCLI 0.1.0 → 0.1.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (308) hide show
  1. checksums.yaml +4 -4
  2. data/Gemfile +3 -0
  3. data/Gemfile.lock +60 -25
  4. data/Notes +1 -1
  5. data/README.md +5 -5
  6. data/Rakefile +2 -0
  7. data/UrgentCare.gemspec +3 -3
  8. data/background.jpg +0 -0
  9. data/lib/UrgentCare.rb +3 -0
  10. data/lib/UrgentCare/CLI.rb +6 -2
  11. data/lib/UrgentCare/version.rb +1 -1
  12. data/lib/Urgentcare/Scraper.rb +65 -23
  13. data/node_modules/.bin/rimraf +1 -0
  14. data/node_modules/.package-lock.json +250 -0
  15. data/node_modules/balanced-match/.github/FUNDING.yml +2 -0
  16. data/node_modules/balanced-match/LICENSE.md +21 -0
  17. data/node_modules/balanced-match/README.md +97 -0
  18. data/node_modules/balanced-match/index.js +62 -0
  19. data/node_modules/balanced-match/package.json +48 -0
  20. data/node_modules/brace-expansion/LICENSE +21 -0
  21. data/node_modules/brace-expansion/README.md +129 -0
  22. data/node_modules/brace-expansion/index.js +201 -0
  23. data/node_modules/brace-expansion/package.json +47 -0
  24. data/node_modules/concat-map/.travis.yml +4 -0
  25. data/node_modules/concat-map/LICENSE +18 -0
  26. data/node_modules/concat-map/README.markdown +62 -0
  27. data/node_modules/concat-map/example/map.js +6 -0
  28. data/node_modules/concat-map/index.js +13 -0
  29. data/node_modules/concat-map/package.json +43 -0
  30. data/node_modules/concat-map/test/map.js +39 -0
  31. data/node_modules/core-util-is/LICENSE +19 -0
  32. data/node_modules/core-util-is/README.md +3 -0
  33. data/node_modules/core-util-is/float.patch +604 -0
  34. data/node_modules/core-util-is/lib/util.js +107 -0
  35. data/node_modules/core-util-is/package.json +32 -0
  36. data/node_modules/core-util-is/test.js +68 -0
  37. data/node_modules/fs.realpath/LICENSE +43 -0
  38. data/node_modules/fs.realpath/README.md +33 -0
  39. data/node_modules/fs.realpath/index.js +66 -0
  40. data/node_modules/fs.realpath/old.js +303 -0
  41. data/node_modules/fs.realpath/package.json +26 -0
  42. data/node_modules/glob/LICENSE +21 -0
  43. data/node_modules/glob/README.md +375 -0
  44. data/node_modules/glob/changelog.md +67 -0
  45. data/node_modules/glob/common.js +234 -0
  46. data/node_modules/glob/glob.js +788 -0
  47. data/node_modules/glob/package.json +51 -0
  48. data/node_modules/glob/sync.js +484 -0
  49. data/node_modules/immediate/LICENSE.txt +20 -0
  50. data/node_modules/immediate/README.md +93 -0
  51. data/node_modules/immediate/dist/immediate.js +75 -0
  52. data/node_modules/immediate/dist/immediate.min.js +1 -0
  53. data/node_modules/immediate/lib/browser.js +69 -0
  54. data/node_modules/immediate/lib/index.js +73 -0
  55. data/node_modules/immediate/package.json +42 -0
  56. data/node_modules/inflight/LICENSE +15 -0
  57. data/node_modules/inflight/README.md +37 -0
  58. data/node_modules/inflight/inflight.js +54 -0
  59. data/node_modules/inflight/package.json +29 -0
  60. data/node_modules/inherits/LICENSE +16 -0
  61. data/node_modules/inherits/README.md +42 -0
  62. data/node_modules/inherits/inherits.js +9 -0
  63. data/node_modules/inherits/inherits_browser.js +27 -0
  64. data/node_modules/inherits/package.json +29 -0
  65. data/node_modules/isarray/.npmignore +1 -0
  66. data/node_modules/isarray/.travis.yml +4 -0
  67. data/node_modules/isarray/Makefile +6 -0
  68. data/node_modules/isarray/README.md +60 -0
  69. data/node_modules/isarray/component.json +19 -0
  70. data/node_modules/isarray/index.js +5 -0
  71. data/node_modules/isarray/package.json +45 -0
  72. data/node_modules/isarray/test.js +20 -0
  73. data/node_modules/jszip/.codeclimate.yml +16 -0
  74. data/node_modules/jszip/.editorconfig +8 -0
  75. data/node_modules/jszip/.jshintignore +1 -0
  76. data/node_modules/jszip/.jshintrc +21 -0
  77. data/node_modules/jszip/.travis.yml +17 -0
  78. data/node_modules/jszip/CHANGES.md +163 -0
  79. data/node_modules/jszip/LICENSE.markdown +651 -0
  80. data/node_modules/jszip/README.markdown +35 -0
  81. data/node_modules/jszip/dist/jszip.js +30 -0
  82. data/node_modules/jszip/dist/jszip.min.js +13 -0
  83. data/node_modules/jszip/index.d.ts +270 -0
  84. data/node_modules/jszip/lib/base64.js +106 -0
  85. data/node_modules/jszip/lib/compressedObject.js +74 -0
  86. data/node_modules/jszip/lib/compressions.js +14 -0
  87. data/node_modules/jszip/lib/crc32.js +77 -0
  88. data/node_modules/jszip/lib/defaults.js +11 -0
  89. data/node_modules/jszip/lib/external.js +19 -0
  90. data/node_modules/jszip/lib/flate.js +85 -0
  91. data/node_modules/jszip/lib/generate/ZipFileWorker.js +540 -0
  92. data/node_modules/jszip/lib/generate/index.js +57 -0
  93. data/node_modules/jszip/lib/index.js +52 -0
  94. data/node_modules/jszip/lib/license_header.js +11 -0
  95. data/node_modules/jszip/lib/load.js +81 -0
  96. data/node_modules/jszip/lib/nodejs/NodejsStreamInputAdapter.js +74 -0
  97. data/node_modules/jszip/lib/nodejs/NodejsStreamOutputAdapter.js +42 -0
  98. data/node_modules/jszip/lib/nodejsUtils.js +57 -0
  99. data/node_modules/jszip/lib/object.js +389 -0
  100. data/node_modules/jszip/lib/readable-stream-browser.js +9 -0
  101. data/node_modules/jszip/lib/reader/ArrayReader.js +57 -0
  102. data/node_modules/jszip/lib/reader/DataReader.js +116 -0
  103. data/node_modules/jszip/lib/reader/NodeBufferReader.js +19 -0
  104. data/node_modules/jszip/lib/reader/StringReader.js +38 -0
  105. data/node_modules/jszip/lib/reader/Uint8ArrayReader.js +22 -0
  106. data/node_modules/jszip/lib/reader/readerFor.js +28 -0
  107. data/node_modules/jszip/lib/signature.js +7 -0
  108. data/node_modules/jszip/lib/stream/ConvertWorker.js +26 -0
  109. data/node_modules/jszip/lib/stream/Crc32Probe.js +24 -0
  110. data/node_modules/jszip/lib/stream/DataLengthProbe.js +29 -0
  111. data/node_modules/jszip/lib/stream/DataWorker.js +116 -0
  112. data/node_modules/jszip/lib/stream/GenericWorker.js +263 -0
  113. data/node_modules/jszip/lib/stream/StreamHelper.js +212 -0
  114. data/node_modules/jszip/lib/support.js +38 -0
  115. data/node_modules/jszip/lib/utf8.js +275 -0
  116. data/node_modules/jszip/lib/utils.js +476 -0
  117. data/node_modules/jszip/lib/zipEntries.js +262 -0
  118. data/node_modules/jszip/lib/zipEntry.js +294 -0
  119. data/node_modules/jszip/lib/zipObject.js +133 -0
  120. data/node_modules/jszip/package.json +63 -0
  121. data/node_modules/jszip/vendor/FileSaver.js +247 -0
  122. data/node_modules/lie/README.md +62 -0
  123. data/node_modules/lie/dist/lie.js +350 -0
  124. data/node_modules/lie/dist/lie.min.js +1 -0
  125. data/node_modules/lie/dist/lie.polyfill.js +358 -0
  126. data/node_modules/lie/dist/lie.polyfill.min.js +1 -0
  127. data/node_modules/lie/lib/browser.js +273 -0
  128. data/node_modules/lie/lib/index.js +298 -0
  129. data/node_modules/lie/license.md +7 -0
  130. data/node_modules/lie/lie.d.ts +244 -0
  131. data/node_modules/lie/package.json +69 -0
  132. data/node_modules/lie/polyfill.js +4 -0
  133. data/node_modules/minimatch/LICENSE +15 -0
  134. data/node_modules/minimatch/README.md +209 -0
  135. data/node_modules/minimatch/minimatch.js +923 -0
  136. data/node_modules/minimatch/package.json +30 -0
  137. data/node_modules/once/LICENSE +15 -0
  138. data/node_modules/once/README.md +79 -0
  139. data/node_modules/once/once.js +42 -0
  140. data/node_modules/once/package.json +33 -0
  141. data/node_modules/pako/CHANGELOG.md +164 -0
  142. data/node_modules/pako/LICENSE +21 -0
  143. data/node_modules/pako/README.md +191 -0
  144. data/node_modules/pako/dist/pako.js +6818 -0
  145. data/node_modules/pako/dist/pako.min.js +1 -0
  146. data/node_modules/pako/dist/pako_deflate.js +3997 -0
  147. data/node_modules/pako/dist/pako_deflate.min.js +1 -0
  148. data/node_modules/pako/dist/pako_inflate.js +3300 -0
  149. data/node_modules/pako/dist/pako_inflate.min.js +1 -0
  150. data/node_modules/pako/index.js +14 -0
  151. data/node_modules/pako/lib/deflate.js +400 -0
  152. data/node_modules/pako/lib/inflate.js +423 -0
  153. data/node_modules/pako/lib/utils/common.js +105 -0
  154. data/node_modules/pako/lib/utils/strings.js +187 -0
  155. data/node_modules/pako/lib/zlib/README +59 -0
  156. data/node_modules/pako/lib/zlib/adler32.js +51 -0
  157. data/node_modules/pako/lib/zlib/constants.js +68 -0
  158. data/node_modules/pako/lib/zlib/crc32.js +59 -0
  159. data/node_modules/pako/lib/zlib/deflate.js +1874 -0
  160. data/node_modules/pako/lib/zlib/gzheader.js +58 -0
  161. data/node_modules/pako/lib/zlib/inffast.js +345 -0
  162. data/node_modules/pako/lib/zlib/inflate.js +1556 -0
  163. data/node_modules/pako/lib/zlib/inftrees.js +343 -0
  164. data/node_modules/pako/lib/zlib/messages.js +32 -0
  165. data/node_modules/pako/lib/zlib/trees.js +1222 -0
  166. data/node_modules/pako/lib/zlib/zstream.js +47 -0
  167. data/node_modules/pako/package.json +44 -0
  168. data/node_modules/path-is-absolute/index.js +20 -0
  169. data/node_modules/path-is-absolute/license +21 -0
  170. data/node_modules/path-is-absolute/package.json +43 -0
  171. data/node_modules/path-is-absolute/readme.md +59 -0
  172. data/node_modules/process-nextick-args/index.js +45 -0
  173. data/node_modules/process-nextick-args/license.md +19 -0
  174. data/node_modules/process-nextick-args/package.json +25 -0
  175. data/node_modules/process-nextick-args/readme.md +18 -0
  176. data/node_modules/readable-stream/.travis.yml +34 -0
  177. data/node_modules/readable-stream/CONTRIBUTING.md +38 -0
  178. data/node_modules/readable-stream/GOVERNANCE.md +136 -0
  179. data/node_modules/readable-stream/LICENSE +47 -0
  180. data/node_modules/readable-stream/README.md +58 -0
  181. data/node_modules/readable-stream/doc/wg-meetings/2015-01-30.md +60 -0
  182. data/node_modules/readable-stream/duplex-browser.js +1 -0
  183. data/node_modules/readable-stream/duplex.js +1 -0
  184. data/node_modules/readable-stream/lib/_stream_duplex.js +131 -0
  185. data/node_modules/readable-stream/lib/_stream_passthrough.js +47 -0
  186. data/node_modules/readable-stream/lib/_stream_readable.js +1019 -0
  187. data/node_modules/readable-stream/lib/_stream_transform.js +214 -0
  188. data/node_modules/readable-stream/lib/_stream_writable.js +687 -0
  189. data/node_modules/readable-stream/lib/internal/streams/BufferList.js +79 -0
  190. data/node_modules/readable-stream/lib/internal/streams/destroy.js +74 -0
  191. data/node_modules/readable-stream/lib/internal/streams/stream-browser.js +1 -0
  192. data/node_modules/readable-stream/lib/internal/streams/stream.js +1 -0
  193. data/node_modules/readable-stream/package.json +52 -0
  194. data/node_modules/readable-stream/passthrough.js +1 -0
  195. data/node_modules/readable-stream/readable-browser.js +7 -0
  196. data/node_modules/readable-stream/readable.js +19 -0
  197. data/node_modules/readable-stream/transform.js +1 -0
  198. data/node_modules/readable-stream/writable-browser.js +1 -0
  199. data/node_modules/readable-stream/writable.js +8 -0
  200. data/node_modules/rimraf/LICENSE +15 -0
  201. data/node_modules/rimraf/README.md +101 -0
  202. data/node_modules/rimraf/bin.js +50 -0
  203. data/node_modules/rimraf/package.json +29 -0
  204. data/node_modules/rimraf/rimraf.js +372 -0
  205. data/node_modules/safe-buffer/LICENSE +21 -0
  206. data/node_modules/safe-buffer/README.md +584 -0
  207. data/node_modules/safe-buffer/index.d.ts +187 -0
  208. data/node_modules/safe-buffer/index.js +62 -0
  209. data/node_modules/safe-buffer/package.json +37 -0
  210. data/node_modules/selenium-webdriver/CHANGES.md +1114 -0
  211. data/node_modules/selenium-webdriver/LICENSE +202 -0
  212. data/node_modules/selenium-webdriver/NOTICE +2 -0
  213. data/node_modules/selenium-webdriver/README.md +229 -0
  214. data/node_modules/selenium-webdriver/chrome.js +295 -0
  215. data/node_modules/selenium-webdriver/chromium.js +829 -0
  216. data/node_modules/selenium-webdriver/devtools/CDPConnection.js +35 -0
  217. data/node_modules/selenium-webdriver/edge.js +224 -0
  218. data/node_modules/selenium-webdriver/example/chrome_android.js +45 -0
  219. data/node_modules/selenium-webdriver/example/chrome_mobile_emulation.js +46 -0
  220. data/node_modules/selenium-webdriver/example/firefox_channels.js +84 -0
  221. data/node_modules/selenium-webdriver/example/google_search.js +50 -0
  222. data/node_modules/selenium-webdriver/example/google_search_test.js +70 -0
  223. data/node_modules/selenium-webdriver/example/headless.js +63 -0
  224. data/node_modules/selenium-webdriver/example/logging.js +64 -0
  225. data/node_modules/selenium-webdriver/firefox.js +789 -0
  226. data/node_modules/selenium-webdriver/http/index.js +324 -0
  227. data/node_modules/selenium-webdriver/http/util.js +172 -0
  228. data/node_modules/selenium-webdriver/ie.js +503 -0
  229. data/node_modules/selenium-webdriver/index.js +825 -0
  230. data/node_modules/selenium-webdriver/io/exec.js +162 -0
  231. data/node_modules/selenium-webdriver/io/index.js +348 -0
  232. data/node_modules/selenium-webdriver/io/zip.js +223 -0
  233. data/node_modules/selenium-webdriver/lib/atoms/find-elements.js +123 -0
  234. data/node_modules/selenium-webdriver/lib/atoms/get-attribute.js +101 -0
  235. data/node_modules/selenium-webdriver/lib/atoms/is-displayed.js +101 -0
  236. data/node_modules/selenium-webdriver/lib/atoms/mutation-listener.js +55 -0
  237. data/node_modules/selenium-webdriver/lib/by.js +415 -0
  238. data/node_modules/selenium-webdriver/lib/capabilities.js +553 -0
  239. data/node_modules/selenium-webdriver/lib/command.js +206 -0
  240. data/node_modules/selenium-webdriver/lib/error.js +605 -0
  241. data/node_modules/selenium-webdriver/lib/http.js +704 -0
  242. data/node_modules/selenium-webdriver/lib/input.js +946 -0
  243. data/node_modules/selenium-webdriver/lib/logging.js +661 -0
  244. data/node_modules/selenium-webdriver/lib/promise.js +285 -0
  245. data/node_modules/selenium-webdriver/lib/proxy.js +212 -0
  246. data/node_modules/selenium-webdriver/lib/session.js +77 -0
  247. data/node_modules/selenium-webdriver/lib/symbols.js +37 -0
  248. data/node_modules/selenium-webdriver/lib/until.js +429 -0
  249. data/node_modules/selenium-webdriver/lib/webdriver.js +2919 -0
  250. data/node_modules/selenium-webdriver/net/index.js +107 -0
  251. data/node_modules/selenium-webdriver/net/portprober.js +75 -0
  252. data/node_modules/selenium-webdriver/opera.js +406 -0
  253. data/node_modules/selenium-webdriver/package.json +54 -0
  254. data/node_modules/selenium-webdriver/proxy.js +32 -0
  255. data/node_modules/selenium-webdriver/remote/index.js +624 -0
  256. data/node_modules/selenium-webdriver/safari.js +168 -0
  257. data/node_modules/selenium-webdriver/testing/index.js +504 -0
  258. data/node_modules/set-immediate-shim/index.js +7 -0
  259. data/node_modules/set-immediate-shim/package.json +34 -0
  260. data/node_modules/set-immediate-shim/readme.md +31 -0
  261. data/node_modules/string_decoder/.travis.yml +50 -0
  262. data/node_modules/string_decoder/LICENSE +48 -0
  263. data/node_modules/string_decoder/README.md +47 -0
  264. data/node_modules/string_decoder/lib/string_decoder.js +296 -0
  265. data/node_modules/string_decoder/package.json +31 -0
  266. data/node_modules/tmp/CHANGELOG.md +288 -0
  267. data/node_modules/tmp/LICENSE +21 -0
  268. data/node_modules/tmp/README.md +365 -0
  269. data/node_modules/tmp/lib/tmp.js +780 -0
  270. data/node_modules/tmp/node_modules/.bin/rimraf +1 -0
  271. data/node_modules/tmp/node_modules/rimraf/CHANGELOG.md +65 -0
  272. data/node_modules/tmp/node_modules/rimraf/LICENSE +15 -0
  273. data/node_modules/tmp/node_modules/rimraf/README.md +101 -0
  274. data/node_modules/tmp/node_modules/rimraf/bin.js +68 -0
  275. data/node_modules/tmp/node_modules/rimraf/package.json +32 -0
  276. data/node_modules/tmp/node_modules/rimraf/rimraf.js +360 -0
  277. data/node_modules/tmp/package.json +58 -0
  278. data/node_modules/util-deprecate/History.md +16 -0
  279. data/node_modules/util-deprecate/LICENSE +24 -0
  280. data/node_modules/util-deprecate/README.md +53 -0
  281. data/node_modules/util-deprecate/browser.js +67 -0
  282. data/node_modules/util-deprecate/node.js +6 -0
  283. data/node_modules/util-deprecate/package.json +27 -0
  284. data/node_modules/wrappy/LICENSE +15 -0
  285. data/node_modules/wrappy/README.md +36 -0
  286. data/node_modules/wrappy/package.json +29 -0
  287. data/node_modules/wrappy/wrappy.js +33 -0
  288. data/node_modules/ws/LICENSE +21 -0
  289. data/node_modules/ws/README.md +496 -0
  290. data/node_modules/ws/browser.js +8 -0
  291. data/node_modules/ws/index.js +10 -0
  292. data/node_modules/ws/lib/buffer-util.js +129 -0
  293. data/node_modules/ws/lib/constants.js +10 -0
  294. data/node_modules/ws/lib/event-target.js +184 -0
  295. data/node_modules/ws/lib/extension.js +223 -0
  296. data/node_modules/ws/lib/limiter.js +55 -0
  297. data/node_modules/ws/lib/permessage-deflate.js +517 -0
  298. data/node_modules/ws/lib/receiver.js +507 -0
  299. data/node_modules/ws/lib/sender.js +405 -0
  300. data/node_modules/ws/lib/stream.js +165 -0
  301. data/node_modules/ws/lib/validation.js +104 -0
  302. data/node_modules/ws/lib/websocket-server.js +418 -0
  303. data/node_modules/ws/lib/websocket.js +942 -0
  304. data/node_modules/ws/package.json +56 -0
  305. data/package-lock.json +458 -0
  306. data/package.json +5 -0
  307. data/selenium.log +1 -0
  308. metadata +314 -19
@@ -0,0 +1,162 @@
1
+ // Licensed to the Software Freedom Conservancy (SFC) under one
2
+ // or more contributor license agreements. See the NOTICE file
3
+ // distributed with this work for additional information
4
+ // regarding copyright ownership. The SFC licenses this file
5
+ // to you under the Apache License, Version 2.0 (the
6
+ // "License"); you may not use this file except in compliance
7
+ // with the License. You may obtain a copy of the License at
8
+ //
9
+ // http://www.apache.org/licenses/LICENSE-2.0
10
+ //
11
+ // Unless required by applicable law or agreed to in writing,
12
+ // software distributed under the License is distributed on an
13
+ // "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
14
+ // KIND, either express or implied. See the License for the
15
+ // specific language governing permissions and limitations
16
+ // under the License.
17
+
18
+ 'use strict'
19
+
20
+ const childProcess = require('child_process')
21
+
22
+ /**
23
+ * Options for configuring an executed command.
24
+ *
25
+ * @record
26
+ */
27
+ class Options {
28
+ constructor() {
29
+ /**
30
+ * Command line arguments for the child process, if any.
31
+ * @type (!Array<string>|undefined)
32
+ */
33
+ this.args
34
+
35
+ /**
36
+ * Environment variables for the spawned process. If unspecified, the
37
+ * child will inherit this process' environment.
38
+ *
39
+ * @type {(!Object<string, string>|undefined)}
40
+ */
41
+ this.env
42
+
43
+ /**
44
+ * IO conifguration for the spawned server child process. If unspecified,
45
+ * the child process' IO output will be ignored.
46
+ *
47
+ * @type {(string|!Array<string|number|!stream.Stream|null|undefined>|
48
+ * undefined)}
49
+ * @see <https://nodejs.org/dist/latest-v8.x/docs/api/child_process.html#child_process_options_stdio>
50
+ */
51
+ this.stdio
52
+ }
53
+ }
54
+
55
+ /**
56
+ * Describes a command's termination conditions.
57
+ */
58
+ class Result {
59
+ /**
60
+ * @param {?number} code The exit code, or {@code null} if the command did not
61
+ * exit normally.
62
+ * @param {?string} signal The signal used to kill the command, or
63
+ * {@code null}.
64
+ */
65
+ constructor(code, signal) {
66
+ /** @type {?number} */
67
+ this.code = code
68
+
69
+ /** @type {?string} */
70
+ this.signal = signal
71
+ }
72
+
73
+ /** @override */
74
+ toString() {
75
+ return `Result(code=${this.code}, signal=${this.signal})`
76
+ }
77
+ }
78
+
79
+ const COMMAND_RESULT = /** !WeakMap<!Command, !Promise<!Result>> */ new WeakMap()
80
+ const KILL_HOOK = /** !WeakMap<!Command, function(string)> */ new WeakMap()
81
+
82
+ /**
83
+ * Represents a command running in a sub-process.
84
+ */
85
+ class Command {
86
+ /**
87
+ * @param {!Promise<!Result>} result The command result.
88
+ * @param {function(string)} onKill The function to call when {@link #kill()}
89
+ * is called.
90
+ */
91
+ constructor(result, onKill) {
92
+ COMMAND_RESULT.set(this, result)
93
+ KILL_HOOK.set(this, onKill)
94
+ }
95
+
96
+ /**
97
+ * @return {!Promise<!Result>} A promise for the result of this
98
+ * command.
99
+ */
100
+ result() {
101
+ return /** @type {!Promise<!Result>} */ (COMMAND_RESULT.get(this))
102
+ }
103
+
104
+ /**
105
+ * Sends a signal to the underlying process.
106
+ * @param {string=} opt_signal The signal to send; defaults to `SIGTERM`.
107
+ */
108
+ kill(opt_signal) {
109
+ KILL_HOOK.get(this)(opt_signal || 'SIGTERM')
110
+ }
111
+ }
112
+
113
+ // PUBLIC API
114
+
115
+ /**
116
+ * Spawns a child process. The returned {@link Command} may be used to wait
117
+ * for the process result or to send signals to the process.
118
+ *
119
+ * @param {string} command The executable to spawn.
120
+ * @param {Options=} opt_options The command options.
121
+ * @return {!Command} The launched command.
122
+ */
123
+ module.exports = function exec(command, opt_options) {
124
+ const options = opt_options || {}
125
+
126
+ let proc = childProcess.spawn(command, options.args || [], {
127
+ env: options.env || process.env,
128
+ stdio: options.stdio || 'ignore',
129
+ })
130
+
131
+ // This process should not wait on the spawned child, however, we do
132
+ // want to ensure the child is killed when this process exits.
133
+ proc.unref()
134
+ process.once('exit', onProcessExit)
135
+
136
+ const result = new Promise((resolve) => {
137
+ proc.once('exit', (code, signal) => {
138
+ proc = null
139
+ process.removeListener('exit', onProcessExit)
140
+ resolve(new Result(code, signal))
141
+ })
142
+ })
143
+ return new Command(result, killCommand)
144
+
145
+ function onProcessExit() {
146
+ killCommand('SIGTERM')
147
+ }
148
+
149
+ function killCommand(signal) {
150
+ process.removeListener('exit', onProcessExit)
151
+ if (proc) {
152
+ proc.kill(signal)
153
+ proc = null
154
+ }
155
+ }
156
+ }
157
+
158
+ // Exported to improve generated API documentation.
159
+
160
+ module.exports.Command = Command
161
+ module.exports.Options = Options
162
+ module.exports.Result = Result
@@ -0,0 +1,348 @@
1
+ // Licensed to the Software Freedom Conservancy (SFC) under one
2
+ // or more contributor license agreements. See the NOTICE file
3
+ // distributed with this work for additional information
4
+ // regarding copyright ownership. The SFC licenses this file
5
+ // to you under the Apache License, Version 2.0 (the
6
+ // "License"); you may not use this file except in compliance
7
+ // with the License. You may obtain a copy of the License at
8
+ //
9
+ // http://www.apache.org/licenses/LICENSE-2.0
10
+ //
11
+ // Unless required by applicable law or agreed to in writing,
12
+ // software distributed under the License is distributed on an
13
+ // "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
14
+ // KIND, either express or implied. See the License for the
15
+ // specific language governing permissions and limitations
16
+ // under the License.
17
+
18
+ 'use strict'
19
+
20
+ const fs = require('fs')
21
+ const path = require('path')
22
+ const rimraf = require('rimraf')
23
+ const tmp = require('tmp')
24
+
25
+ /**
26
+ * @param {!Function} fn .
27
+ * @return {!Promise<T>} .
28
+ * @template T
29
+ */
30
+ function checkedCall(fn) {
31
+ return new Promise((resolve, reject) => {
32
+ try {
33
+ fn((err, value) => {
34
+ if (err) {
35
+ reject(err)
36
+ } else {
37
+ resolve(value)
38
+ }
39
+ })
40
+ } catch (e) {
41
+ reject(e)
42
+ }
43
+ })
44
+ }
45
+
46
+ // PUBLIC API
47
+
48
+ /**
49
+ * Recursively removes a directory and all of its contents. This is equivalent
50
+ * to {@code rm -rf} on a POSIX system.
51
+ * @param {string} dirPath Path to the directory to remove.
52
+ * @return {!Promise} A promise to be resolved when the operation has
53
+ * completed.
54
+ */
55
+ exports.rmDir = function (dirPath) {
56
+ return new Promise(function (fulfill, reject) {
57
+ var numAttempts = 0
58
+ attemptRm()
59
+ function attemptRm() {
60
+ numAttempts += 1
61
+ rimraf(dirPath, function (err) {
62
+ if (err) {
63
+ if (err.code && err.code === 'ENOTEMPTY' && numAttempts < 2) {
64
+ attemptRm()
65
+ return
66
+ }
67
+ reject(err)
68
+ } else {
69
+ fulfill()
70
+ }
71
+ })
72
+ }
73
+ })
74
+ }
75
+
76
+ /**
77
+ * Copies one file to another.
78
+ * @param {string} src The source file.
79
+ * @param {string} dst The destination file.
80
+ * @return {!Promise<string>} A promise for the copied file's path.
81
+ */
82
+ exports.copy = function (src, dst) {
83
+ return new Promise(function (fulfill, reject) {
84
+ var rs = fs.createReadStream(src)
85
+ rs.on('error', reject)
86
+
87
+ var ws = fs.createWriteStream(dst)
88
+ ws.on('error', reject)
89
+ ws.on('close', () => fulfill(dst))
90
+
91
+ rs.pipe(ws)
92
+ })
93
+ }
94
+
95
+ /**
96
+ * Recursively copies the contents of one directory to another.
97
+ * @param {string} src The source directory to copy.
98
+ * @param {string} dst The directory to copy into.
99
+ * @param {(RegExp|function(string): boolean)=} opt_exclude An exclusion filter
100
+ * as either a regex or predicate function. All files matching this filter
101
+ * will not be copied.
102
+ * @return {!Promise<string>} A promise for the destination
103
+ * directory's path once all files have been copied.
104
+ */
105
+ exports.copyDir = function (src, dst, opt_exclude) {
106
+ var predicate = opt_exclude
107
+ if (opt_exclude && typeof opt_exclude !== 'function') {
108
+ predicate = function (p) {
109
+ return !opt_exclude.test(p)
110
+ }
111
+ }
112
+
113
+ // TODO(jleyba): Make this function completely async.
114
+ if (!fs.existsSync(dst)) {
115
+ fs.mkdirSync(dst)
116
+ }
117
+
118
+ var files = fs.readdirSync(src)
119
+ files = files.map(function (file) {
120
+ return path.join(src, file)
121
+ })
122
+
123
+ if (predicate) {
124
+ files = files.filter(/** @type {function(string): boolean} */ (predicate))
125
+ }
126
+
127
+ var results = []
128
+ files.forEach(function (file) {
129
+ var stats = fs.statSync(file)
130
+ var target = path.join(dst, path.basename(file))
131
+
132
+ if (stats.isDirectory()) {
133
+ if (!fs.existsSync(target)) {
134
+ fs.mkdirSync(target, stats.mode)
135
+ }
136
+ results.push(exports.copyDir(file, target, predicate))
137
+ } else {
138
+ results.push(exports.copy(file, target))
139
+ }
140
+ })
141
+
142
+ return Promise.all(results).then(() => dst)
143
+ }
144
+
145
+ /**
146
+ * Tests if a file path exists.
147
+ * @param {string} aPath The path to test.
148
+ * @return {!Promise<boolean>} A promise for whether the file exists.
149
+ */
150
+ exports.exists = function (aPath) {
151
+ return new Promise(function (fulfill, reject) {
152
+ let type = typeof aPath
153
+ if (type !== 'string') {
154
+ reject(TypeError(`expected string path, but got ${type}`))
155
+ } else {
156
+ // eslint-disable-next-line node/no-deprecated-api
157
+ fs.exists(aPath, fulfill)
158
+ }
159
+ })
160
+ }
161
+
162
+ /**
163
+ * Calls `stat(2)`.
164
+ * @param {string} aPath The path to stat.
165
+ * @return {!Promise<!fs.Stats>} A promise for the file stats.
166
+ */
167
+ exports.stat = function stat(aPath) {
168
+ return checkedCall((callback) => fs.stat(aPath, callback))
169
+ }
170
+
171
+ /**
172
+ * Deletes a name from the filesystem and possibly the file it refers to. Has
173
+ * no effect if the file does not exist.
174
+ * @param {string} aPath The path to remove.
175
+ * @return {!Promise} A promise for when the file has been removed.
176
+ */
177
+ exports.unlink = function (aPath) {
178
+ return new Promise(function (fulfill, reject) {
179
+ // eslint-disable-next-line node/no-deprecated-api
180
+ fs.exists(aPath, function (exists) {
181
+ if (exists) {
182
+ fs.unlink(aPath, function (err) {
183
+ ;(err && reject(err)) || fulfill()
184
+ })
185
+ } else {
186
+ fulfill()
187
+ }
188
+ })
189
+ })
190
+ }
191
+
192
+ /**
193
+ * @return {!Promise<string>} A promise for the path to a temporary directory.
194
+ * @see https://www.npmjs.org/package/tmp
195
+ */
196
+ exports.tmpDir = function () {
197
+ return checkedCall((callback) => tmp.dir({ unsafeCleanup: true }, callback))
198
+ }
199
+
200
+ /**
201
+ * @param {{postfix: string}=} opt_options Temporary file options.
202
+ * @return {!Promise<string>} A promise for the path to a temporary file.
203
+ * @see https://www.npmjs.org/package/tmp
204
+ */
205
+ exports.tmpFile = function (opt_options) {
206
+ return checkedCall((callback) => {
207
+ /** check fixed in v > 0.2.1 if
208
+ * (typeof options === 'function') {
209
+ * return [{}, options];
210
+ * }
211
+ */
212
+ tmp.file(opt_options, callback)
213
+ })
214
+ }
215
+
216
+ /**
217
+ * Searches the {@code PATH} environment variable for the given file.
218
+ * @param {string} file The file to locate on the PATH.
219
+ * @param {boolean=} opt_checkCwd Whether to always start with the search with
220
+ * the current working directory, regardless of whether it is explicitly
221
+ * listed on the PATH.
222
+ * @return {?string} Path to the located file, or {@code null} if it could
223
+ * not be found.
224
+ */
225
+ exports.findInPath = function (file, opt_checkCwd) {
226
+ const dirs = []
227
+ if (opt_checkCwd) {
228
+ dirs.push(process.cwd())
229
+ }
230
+ dirs.push.apply(dirs, process.env['PATH'].split(path.delimiter))
231
+
232
+ let foundInDir = dirs.find((dir) => {
233
+ let tmp = path.join(dir, file)
234
+ try {
235
+ let stats = fs.statSync(tmp)
236
+ return stats.isFile() && !stats.isDirectory()
237
+ } catch (ex) {
238
+ return false
239
+ }
240
+ })
241
+
242
+ return foundInDir ? path.join(foundInDir, file) : null
243
+ }
244
+
245
+ /**
246
+ * Reads the contents of the given file.
247
+ *
248
+ * @param {string} aPath Path to the file to read.
249
+ * @return {!Promise<!Buffer>} A promise that will resolve with a buffer of the
250
+ * file contents.
251
+ */
252
+ exports.read = function (aPath) {
253
+ return checkedCall((callback) => fs.readFile(aPath, callback))
254
+ }
255
+
256
+ /**
257
+ * Writes to a file.
258
+ *
259
+ * @param {string} aPath Path to the file to write to.
260
+ * @param {(string|!Buffer)} data The data to write.
261
+ * @return {!Promise} A promise that will resolve when the operation has
262
+ * completed.
263
+ */
264
+ exports.write = function (aPath, data) {
265
+ return checkedCall((callback) => fs.writeFile(aPath, data, callback))
266
+ }
267
+
268
+ /**
269
+ * Creates a directory.
270
+ *
271
+ * @param {string} aPath The directory path.
272
+ * @return {!Promise<string>} A promise that will resolve with the path of the
273
+ * created directory.
274
+ */
275
+ exports.mkdir = function (aPath) {
276
+ return checkedCall((callback) => {
277
+ fs.mkdir(aPath, undefined, (err) => {
278
+ if (err && err.code !== 'EEXIST') {
279
+ callback(err)
280
+ } else {
281
+ callback(null, aPath)
282
+ }
283
+ })
284
+ })
285
+ }
286
+
287
+ /**
288
+ * Recursively creates a directory and any ancestors that do not yet exist.
289
+ *
290
+ * @param {string} dir The directory path to create.
291
+ * @return {!Promise<string>} A promise that will resolve with the path of the
292
+ * created directory.
293
+ */
294
+ exports.mkdirp = function mkdirp(dir) {
295
+ return checkedCall((callback) => {
296
+ fs.mkdir(dir, undefined, (err) => {
297
+ if (!err) {
298
+ callback(null, dir)
299
+ return
300
+ }
301
+
302
+ switch (err.code) {
303
+ case 'EEXIST':
304
+ callback(null, dir)
305
+ return
306
+ case 'ENOENT':
307
+ return mkdirp(path.dirname(dir))
308
+ .then(() => mkdirp(dir))
309
+ .then(
310
+ () => callback(null, dir),
311
+ (err) => callback(err)
312
+ )
313
+ default:
314
+ callback(err)
315
+ return
316
+ }
317
+ })
318
+ })
319
+ }
320
+
321
+ /**
322
+ * Recursively walks a directory, returning a promise that will resolve with
323
+ * a list of all files/directories seen.
324
+ *
325
+ * @param {string} rootPath the directory to walk.
326
+ * @return {!Promise<!Array<{path: string, dir: boolean}>>} a promise that will
327
+ * resolve with a list of entries seen. For each entry, the recorded path
328
+ * will be relative to `rootPath`.
329
+ */
330
+ exports.walkDir = function (rootPath) {
331
+ const seen = []
332
+ return (function walk(dir) {
333
+ return checkedCall((callback) => fs.readdir(dir, callback)).then((files) =>
334
+ Promise.all(
335
+ files.map((file) => {
336
+ file = path.join(dir, file)
337
+ return checkedCall((cb) => fs.stat(file, cb)).then((stats) => {
338
+ seen.push({
339
+ path: path.relative(rootPath, file),
340
+ dir: stats.isDirectory(),
341
+ })
342
+ return stats.isDirectory() && walk(file)
343
+ })
344
+ })
345
+ )
346
+ )
347
+ })(rootPath).then(() => seen)
348
+ }