UrgentcareCLI 0.1.0 → 0.1.1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/Gemfile +3 -0
- data/Gemfile.lock +60 -25
- data/Notes +1 -1
- data/README.md +5 -5
- data/Rakefile +2 -0
- data/UrgentCare.gemspec +3 -3
- data/background.jpg +0 -0
- data/lib/UrgentCare.rb +3 -0
- data/lib/UrgentCare/CLI.rb +6 -2
- data/lib/UrgentCare/version.rb +1 -1
- data/lib/Urgentcare/Scraper.rb +65 -23
- data/node_modules/.bin/rimraf +1 -0
- data/node_modules/.package-lock.json +250 -0
- data/node_modules/balanced-match/.github/FUNDING.yml +2 -0
- data/node_modules/balanced-match/LICENSE.md +21 -0
- data/node_modules/balanced-match/README.md +97 -0
- data/node_modules/balanced-match/index.js +62 -0
- data/node_modules/balanced-match/package.json +48 -0
- data/node_modules/brace-expansion/LICENSE +21 -0
- data/node_modules/brace-expansion/README.md +129 -0
- data/node_modules/brace-expansion/index.js +201 -0
- data/node_modules/brace-expansion/package.json +47 -0
- data/node_modules/concat-map/.travis.yml +4 -0
- data/node_modules/concat-map/LICENSE +18 -0
- data/node_modules/concat-map/README.markdown +62 -0
- data/node_modules/concat-map/example/map.js +6 -0
- data/node_modules/concat-map/index.js +13 -0
- data/node_modules/concat-map/package.json +43 -0
- data/node_modules/concat-map/test/map.js +39 -0
- data/node_modules/core-util-is/LICENSE +19 -0
- data/node_modules/core-util-is/README.md +3 -0
- data/node_modules/core-util-is/float.patch +604 -0
- data/node_modules/core-util-is/lib/util.js +107 -0
- data/node_modules/core-util-is/package.json +32 -0
- data/node_modules/core-util-is/test.js +68 -0
- data/node_modules/fs.realpath/LICENSE +43 -0
- data/node_modules/fs.realpath/README.md +33 -0
- data/node_modules/fs.realpath/index.js +66 -0
- data/node_modules/fs.realpath/old.js +303 -0
- data/node_modules/fs.realpath/package.json +26 -0
- data/node_modules/glob/LICENSE +21 -0
- data/node_modules/glob/README.md +375 -0
- data/node_modules/glob/changelog.md +67 -0
- data/node_modules/glob/common.js +234 -0
- data/node_modules/glob/glob.js +788 -0
- data/node_modules/glob/package.json +51 -0
- data/node_modules/glob/sync.js +484 -0
- data/node_modules/immediate/LICENSE.txt +20 -0
- data/node_modules/immediate/README.md +93 -0
- data/node_modules/immediate/dist/immediate.js +75 -0
- data/node_modules/immediate/dist/immediate.min.js +1 -0
- data/node_modules/immediate/lib/browser.js +69 -0
- data/node_modules/immediate/lib/index.js +73 -0
- data/node_modules/immediate/package.json +42 -0
- data/node_modules/inflight/LICENSE +15 -0
- data/node_modules/inflight/README.md +37 -0
- data/node_modules/inflight/inflight.js +54 -0
- data/node_modules/inflight/package.json +29 -0
- data/node_modules/inherits/LICENSE +16 -0
- data/node_modules/inherits/README.md +42 -0
- data/node_modules/inherits/inherits.js +9 -0
- data/node_modules/inherits/inherits_browser.js +27 -0
- data/node_modules/inherits/package.json +29 -0
- data/node_modules/isarray/.npmignore +1 -0
- data/node_modules/isarray/.travis.yml +4 -0
- data/node_modules/isarray/Makefile +6 -0
- data/node_modules/isarray/README.md +60 -0
- data/node_modules/isarray/component.json +19 -0
- data/node_modules/isarray/index.js +5 -0
- data/node_modules/isarray/package.json +45 -0
- data/node_modules/isarray/test.js +20 -0
- data/node_modules/jszip/.codeclimate.yml +16 -0
- data/node_modules/jszip/.editorconfig +8 -0
- data/node_modules/jszip/.jshintignore +1 -0
- data/node_modules/jszip/.jshintrc +21 -0
- data/node_modules/jszip/.travis.yml +17 -0
- data/node_modules/jszip/CHANGES.md +163 -0
- data/node_modules/jszip/LICENSE.markdown +651 -0
- data/node_modules/jszip/README.markdown +35 -0
- data/node_modules/jszip/dist/jszip.js +30 -0
- data/node_modules/jszip/dist/jszip.min.js +13 -0
- data/node_modules/jszip/index.d.ts +270 -0
- data/node_modules/jszip/lib/base64.js +106 -0
- data/node_modules/jszip/lib/compressedObject.js +74 -0
- data/node_modules/jszip/lib/compressions.js +14 -0
- data/node_modules/jszip/lib/crc32.js +77 -0
- data/node_modules/jszip/lib/defaults.js +11 -0
- data/node_modules/jszip/lib/external.js +19 -0
- data/node_modules/jszip/lib/flate.js +85 -0
- data/node_modules/jszip/lib/generate/ZipFileWorker.js +540 -0
- data/node_modules/jszip/lib/generate/index.js +57 -0
- data/node_modules/jszip/lib/index.js +52 -0
- data/node_modules/jszip/lib/license_header.js +11 -0
- data/node_modules/jszip/lib/load.js +81 -0
- data/node_modules/jszip/lib/nodejs/NodejsStreamInputAdapter.js +74 -0
- data/node_modules/jszip/lib/nodejs/NodejsStreamOutputAdapter.js +42 -0
- data/node_modules/jszip/lib/nodejsUtils.js +57 -0
- data/node_modules/jszip/lib/object.js +389 -0
- data/node_modules/jszip/lib/readable-stream-browser.js +9 -0
- data/node_modules/jszip/lib/reader/ArrayReader.js +57 -0
- data/node_modules/jszip/lib/reader/DataReader.js +116 -0
- data/node_modules/jszip/lib/reader/NodeBufferReader.js +19 -0
- data/node_modules/jszip/lib/reader/StringReader.js +38 -0
- data/node_modules/jszip/lib/reader/Uint8ArrayReader.js +22 -0
- data/node_modules/jszip/lib/reader/readerFor.js +28 -0
- data/node_modules/jszip/lib/signature.js +7 -0
- data/node_modules/jszip/lib/stream/ConvertWorker.js +26 -0
- data/node_modules/jszip/lib/stream/Crc32Probe.js +24 -0
- data/node_modules/jszip/lib/stream/DataLengthProbe.js +29 -0
- data/node_modules/jszip/lib/stream/DataWorker.js +116 -0
- data/node_modules/jszip/lib/stream/GenericWorker.js +263 -0
- data/node_modules/jszip/lib/stream/StreamHelper.js +212 -0
- data/node_modules/jszip/lib/support.js +38 -0
- data/node_modules/jszip/lib/utf8.js +275 -0
- data/node_modules/jszip/lib/utils.js +476 -0
- data/node_modules/jszip/lib/zipEntries.js +262 -0
- data/node_modules/jszip/lib/zipEntry.js +294 -0
- data/node_modules/jszip/lib/zipObject.js +133 -0
- data/node_modules/jszip/package.json +63 -0
- data/node_modules/jszip/vendor/FileSaver.js +247 -0
- data/node_modules/lie/README.md +62 -0
- data/node_modules/lie/dist/lie.js +350 -0
- data/node_modules/lie/dist/lie.min.js +1 -0
- data/node_modules/lie/dist/lie.polyfill.js +358 -0
- data/node_modules/lie/dist/lie.polyfill.min.js +1 -0
- data/node_modules/lie/lib/browser.js +273 -0
- data/node_modules/lie/lib/index.js +298 -0
- data/node_modules/lie/license.md +7 -0
- data/node_modules/lie/lie.d.ts +244 -0
- data/node_modules/lie/package.json +69 -0
- data/node_modules/lie/polyfill.js +4 -0
- data/node_modules/minimatch/LICENSE +15 -0
- data/node_modules/minimatch/README.md +209 -0
- data/node_modules/minimatch/minimatch.js +923 -0
- data/node_modules/minimatch/package.json +30 -0
- data/node_modules/once/LICENSE +15 -0
- data/node_modules/once/README.md +79 -0
- data/node_modules/once/once.js +42 -0
- data/node_modules/once/package.json +33 -0
- data/node_modules/pako/CHANGELOG.md +164 -0
- data/node_modules/pako/LICENSE +21 -0
- data/node_modules/pako/README.md +191 -0
- data/node_modules/pako/dist/pako.js +6818 -0
- data/node_modules/pako/dist/pako.min.js +1 -0
- data/node_modules/pako/dist/pako_deflate.js +3997 -0
- data/node_modules/pako/dist/pako_deflate.min.js +1 -0
- data/node_modules/pako/dist/pako_inflate.js +3300 -0
- data/node_modules/pako/dist/pako_inflate.min.js +1 -0
- data/node_modules/pako/index.js +14 -0
- data/node_modules/pako/lib/deflate.js +400 -0
- data/node_modules/pako/lib/inflate.js +423 -0
- data/node_modules/pako/lib/utils/common.js +105 -0
- data/node_modules/pako/lib/utils/strings.js +187 -0
- data/node_modules/pako/lib/zlib/README +59 -0
- data/node_modules/pako/lib/zlib/adler32.js +51 -0
- data/node_modules/pako/lib/zlib/constants.js +68 -0
- data/node_modules/pako/lib/zlib/crc32.js +59 -0
- data/node_modules/pako/lib/zlib/deflate.js +1874 -0
- data/node_modules/pako/lib/zlib/gzheader.js +58 -0
- data/node_modules/pako/lib/zlib/inffast.js +345 -0
- data/node_modules/pako/lib/zlib/inflate.js +1556 -0
- data/node_modules/pako/lib/zlib/inftrees.js +343 -0
- data/node_modules/pako/lib/zlib/messages.js +32 -0
- data/node_modules/pako/lib/zlib/trees.js +1222 -0
- data/node_modules/pako/lib/zlib/zstream.js +47 -0
- data/node_modules/pako/package.json +44 -0
- data/node_modules/path-is-absolute/index.js +20 -0
- data/node_modules/path-is-absolute/license +21 -0
- data/node_modules/path-is-absolute/package.json +43 -0
- data/node_modules/path-is-absolute/readme.md +59 -0
- data/node_modules/process-nextick-args/index.js +45 -0
- data/node_modules/process-nextick-args/license.md +19 -0
- data/node_modules/process-nextick-args/package.json +25 -0
- data/node_modules/process-nextick-args/readme.md +18 -0
- data/node_modules/readable-stream/.travis.yml +34 -0
- data/node_modules/readable-stream/CONTRIBUTING.md +38 -0
- data/node_modules/readable-stream/GOVERNANCE.md +136 -0
- data/node_modules/readable-stream/LICENSE +47 -0
- data/node_modules/readable-stream/README.md +58 -0
- data/node_modules/readable-stream/doc/wg-meetings/2015-01-30.md +60 -0
- data/node_modules/readable-stream/duplex-browser.js +1 -0
- data/node_modules/readable-stream/duplex.js +1 -0
- data/node_modules/readable-stream/lib/_stream_duplex.js +131 -0
- data/node_modules/readable-stream/lib/_stream_passthrough.js +47 -0
- data/node_modules/readable-stream/lib/_stream_readable.js +1019 -0
- data/node_modules/readable-stream/lib/_stream_transform.js +214 -0
- data/node_modules/readable-stream/lib/_stream_writable.js +687 -0
- data/node_modules/readable-stream/lib/internal/streams/BufferList.js +79 -0
- data/node_modules/readable-stream/lib/internal/streams/destroy.js +74 -0
- data/node_modules/readable-stream/lib/internal/streams/stream-browser.js +1 -0
- data/node_modules/readable-stream/lib/internal/streams/stream.js +1 -0
- data/node_modules/readable-stream/package.json +52 -0
- data/node_modules/readable-stream/passthrough.js +1 -0
- data/node_modules/readable-stream/readable-browser.js +7 -0
- data/node_modules/readable-stream/readable.js +19 -0
- data/node_modules/readable-stream/transform.js +1 -0
- data/node_modules/readable-stream/writable-browser.js +1 -0
- data/node_modules/readable-stream/writable.js +8 -0
- data/node_modules/rimraf/LICENSE +15 -0
- data/node_modules/rimraf/README.md +101 -0
- data/node_modules/rimraf/bin.js +50 -0
- data/node_modules/rimraf/package.json +29 -0
- data/node_modules/rimraf/rimraf.js +372 -0
- data/node_modules/safe-buffer/LICENSE +21 -0
- data/node_modules/safe-buffer/README.md +584 -0
- data/node_modules/safe-buffer/index.d.ts +187 -0
- data/node_modules/safe-buffer/index.js +62 -0
- data/node_modules/safe-buffer/package.json +37 -0
- data/node_modules/selenium-webdriver/CHANGES.md +1114 -0
- data/node_modules/selenium-webdriver/LICENSE +202 -0
- data/node_modules/selenium-webdriver/NOTICE +2 -0
- data/node_modules/selenium-webdriver/README.md +229 -0
- data/node_modules/selenium-webdriver/chrome.js +295 -0
- data/node_modules/selenium-webdriver/chromium.js +829 -0
- data/node_modules/selenium-webdriver/devtools/CDPConnection.js +35 -0
- data/node_modules/selenium-webdriver/edge.js +224 -0
- data/node_modules/selenium-webdriver/example/chrome_android.js +45 -0
- data/node_modules/selenium-webdriver/example/chrome_mobile_emulation.js +46 -0
- data/node_modules/selenium-webdriver/example/firefox_channels.js +84 -0
- data/node_modules/selenium-webdriver/example/google_search.js +50 -0
- data/node_modules/selenium-webdriver/example/google_search_test.js +70 -0
- data/node_modules/selenium-webdriver/example/headless.js +63 -0
- data/node_modules/selenium-webdriver/example/logging.js +64 -0
- data/node_modules/selenium-webdriver/firefox.js +789 -0
- data/node_modules/selenium-webdriver/http/index.js +324 -0
- data/node_modules/selenium-webdriver/http/util.js +172 -0
- data/node_modules/selenium-webdriver/ie.js +503 -0
- data/node_modules/selenium-webdriver/index.js +825 -0
- data/node_modules/selenium-webdriver/io/exec.js +162 -0
- data/node_modules/selenium-webdriver/io/index.js +348 -0
- data/node_modules/selenium-webdriver/io/zip.js +223 -0
- data/node_modules/selenium-webdriver/lib/atoms/find-elements.js +123 -0
- data/node_modules/selenium-webdriver/lib/atoms/get-attribute.js +101 -0
- data/node_modules/selenium-webdriver/lib/atoms/is-displayed.js +101 -0
- data/node_modules/selenium-webdriver/lib/atoms/mutation-listener.js +55 -0
- data/node_modules/selenium-webdriver/lib/by.js +415 -0
- data/node_modules/selenium-webdriver/lib/capabilities.js +553 -0
- data/node_modules/selenium-webdriver/lib/command.js +206 -0
- data/node_modules/selenium-webdriver/lib/error.js +605 -0
- data/node_modules/selenium-webdriver/lib/http.js +704 -0
- data/node_modules/selenium-webdriver/lib/input.js +946 -0
- data/node_modules/selenium-webdriver/lib/logging.js +661 -0
- data/node_modules/selenium-webdriver/lib/promise.js +285 -0
- data/node_modules/selenium-webdriver/lib/proxy.js +212 -0
- data/node_modules/selenium-webdriver/lib/session.js +77 -0
- data/node_modules/selenium-webdriver/lib/symbols.js +37 -0
- data/node_modules/selenium-webdriver/lib/until.js +429 -0
- data/node_modules/selenium-webdriver/lib/webdriver.js +2919 -0
- data/node_modules/selenium-webdriver/net/index.js +107 -0
- data/node_modules/selenium-webdriver/net/portprober.js +75 -0
- data/node_modules/selenium-webdriver/opera.js +406 -0
- data/node_modules/selenium-webdriver/package.json +54 -0
- data/node_modules/selenium-webdriver/proxy.js +32 -0
- data/node_modules/selenium-webdriver/remote/index.js +624 -0
- data/node_modules/selenium-webdriver/safari.js +168 -0
- data/node_modules/selenium-webdriver/testing/index.js +504 -0
- data/node_modules/set-immediate-shim/index.js +7 -0
- data/node_modules/set-immediate-shim/package.json +34 -0
- data/node_modules/set-immediate-shim/readme.md +31 -0
- data/node_modules/string_decoder/.travis.yml +50 -0
- data/node_modules/string_decoder/LICENSE +48 -0
- data/node_modules/string_decoder/README.md +47 -0
- data/node_modules/string_decoder/lib/string_decoder.js +296 -0
- data/node_modules/string_decoder/package.json +31 -0
- data/node_modules/tmp/CHANGELOG.md +288 -0
- data/node_modules/tmp/LICENSE +21 -0
- data/node_modules/tmp/README.md +365 -0
- data/node_modules/tmp/lib/tmp.js +780 -0
- data/node_modules/tmp/node_modules/.bin/rimraf +1 -0
- data/node_modules/tmp/node_modules/rimraf/CHANGELOG.md +65 -0
- data/node_modules/tmp/node_modules/rimraf/LICENSE +15 -0
- data/node_modules/tmp/node_modules/rimraf/README.md +101 -0
- data/node_modules/tmp/node_modules/rimraf/bin.js +68 -0
- data/node_modules/tmp/node_modules/rimraf/package.json +32 -0
- data/node_modules/tmp/node_modules/rimraf/rimraf.js +360 -0
- data/node_modules/tmp/package.json +58 -0
- data/node_modules/util-deprecate/History.md +16 -0
- data/node_modules/util-deprecate/LICENSE +24 -0
- data/node_modules/util-deprecate/README.md +53 -0
- data/node_modules/util-deprecate/browser.js +67 -0
- data/node_modules/util-deprecate/node.js +6 -0
- data/node_modules/util-deprecate/package.json +27 -0
- data/node_modules/wrappy/LICENSE +15 -0
- data/node_modules/wrappy/README.md +36 -0
- data/node_modules/wrappy/package.json +29 -0
- data/node_modules/wrappy/wrappy.js +33 -0
- data/node_modules/ws/LICENSE +21 -0
- data/node_modules/ws/README.md +496 -0
- data/node_modules/ws/browser.js +8 -0
- data/node_modules/ws/index.js +10 -0
- data/node_modules/ws/lib/buffer-util.js +129 -0
- data/node_modules/ws/lib/constants.js +10 -0
- data/node_modules/ws/lib/event-target.js +184 -0
- data/node_modules/ws/lib/extension.js +223 -0
- data/node_modules/ws/lib/limiter.js +55 -0
- data/node_modules/ws/lib/permessage-deflate.js +517 -0
- data/node_modules/ws/lib/receiver.js +507 -0
- data/node_modules/ws/lib/sender.js +405 -0
- data/node_modules/ws/lib/stream.js +165 -0
- data/node_modules/ws/lib/validation.js +104 -0
- data/node_modules/ws/lib/websocket-server.js +418 -0
- data/node_modules/ws/lib/websocket.js +942 -0
- data/node_modules/ws/package.json +56 -0
- data/package-lock.json +458 -0
- data/package.json +5 -0
- data/selenium.log +1 -0
- 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
|
+
}
|