browsed 0.2.5 → 0.2.6

Sign up to get free protection for your applications and to get access to all the features.
Files changed (172) hide show
  1. checksums.yaml +4 -4
  2. data/.gitignore +2 -0
  3. data/Gemfile.lock +2 -2
  4. data/README.md +12 -17
  5. data/bin/browse +13 -10
  6. data/lib/browsed.rb +9 -2
  7. data/lib/browsed/browser.rb +82 -0
  8. data/lib/browsed/chrome.rb +21 -12
  9. data/lib/browsed/client.rb +48 -130
  10. data/lib/browsed/constants.rb +7 -1
  11. data/lib/browsed/errors.rb +1 -0
  12. data/lib/browsed/extensions/hash.rb +27 -0
  13. data/lib/browsed/firefox.rb +18 -17
  14. data/lib/browsed/manager.rb +5 -5
  15. data/lib/browsed/{poltergeist.rb → phantomjs.rb} +2 -2
  16. data/lib/browsed/proxies.rb +26 -0
  17. data/lib/browsed/{extensions → proxies}/chrome/proxy_authentication.rb +3 -3
  18. data/lib/browsed/proxies/proxy-chain-server/node_modules/.bin/portastic +1 -0
  19. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/LICENSE +21 -0
  20. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/README.md +57 -0
  21. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/changelog.md +1 -0
  22. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/browser/bluebird.core.js +3824 -0
  23. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/browser/bluebird.core.min.js +31 -0
  24. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/browser/bluebird.js +5666 -0
  25. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/browser/bluebird.min.js +31 -0
  26. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/any.js +21 -0
  27. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/assert.js +55 -0
  28. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/async.js +165 -0
  29. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/bind.js +67 -0
  30. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/bluebird.js +11 -0
  31. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/call_get.js +123 -0
  32. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/cancel.js +129 -0
  33. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/catch_filter.js +42 -0
  34. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/context.js +69 -0
  35. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/debuggability.js +934 -0
  36. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/direct_resolve.js +46 -0
  37. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/each.js +30 -0
  38. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/errors.js +116 -0
  39. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/es5.js +80 -0
  40. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/filter.js +12 -0
  41. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/finally.js +146 -0
  42. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/generators.js +223 -0
  43. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/join.js +168 -0
  44. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/map.js +168 -0
  45. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/method.js +55 -0
  46. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/nodeback.js +51 -0
  47. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/nodeify.js +58 -0
  48. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/promise.js +789 -0
  49. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/promise_array.js +185 -0
  50. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/promisify.js +314 -0
  51. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/props.js +118 -0
  52. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/queue.js +73 -0
  53. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/race.js +49 -0
  54. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/reduce.js +172 -0
  55. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/schedule.js +62 -0
  56. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/settle.js +43 -0
  57. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/some.js +148 -0
  58. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/synchronous_inspection.js +103 -0
  59. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/thenables.js +86 -0
  60. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/timers.js +93 -0
  61. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/using.js +226 -0
  62. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/js/release/util.js +389 -0
  63. data/lib/browsed/proxies/proxy-chain-server/node_modules/bluebird/package.json +102 -0
  64. data/lib/browsed/proxies/proxy-chain-server/node_modules/commander/CHANGELOG.md +408 -0
  65. data/lib/browsed/proxies/proxy-chain-server/node_modules/commander/LICENSE +22 -0
  66. data/lib/browsed/proxies/proxy-chain-server/node_modules/commander/Readme.md +428 -0
  67. data/lib/browsed/proxies/proxy-chain-server/node_modules/commander/index.js +1224 -0
  68. data/lib/browsed/proxies/proxy-chain-server/node_modules/commander/package.json +70 -0
  69. data/lib/browsed/proxies/proxy-chain-server/node_modules/commander/typings/index.d.ts +310 -0
  70. data/lib/browsed/proxies/proxy-chain-server/node_modules/debug/.coveralls.yml +1 -0
  71. data/lib/browsed/proxies/proxy-chain-server/node_modules/debug/.eslintrc +11 -0
  72. data/lib/browsed/proxies/proxy-chain-server/node_modules/debug/.npmignore +9 -0
  73. data/lib/browsed/proxies/proxy-chain-server/node_modules/debug/.travis.yml +14 -0
  74. data/lib/browsed/proxies/proxy-chain-server/node_modules/debug/CHANGELOG.md +362 -0
  75. data/lib/browsed/proxies/proxy-chain-server/node_modules/debug/LICENSE +19 -0
  76. data/lib/browsed/proxies/proxy-chain-server/node_modules/debug/Makefile +50 -0
  77. data/lib/browsed/proxies/proxy-chain-server/node_modules/debug/README.md +312 -0
  78. data/lib/browsed/proxies/proxy-chain-server/node_modules/debug/component.json +19 -0
  79. data/lib/browsed/proxies/proxy-chain-server/node_modules/debug/karma.conf.js +70 -0
  80. data/lib/browsed/proxies/proxy-chain-server/node_modules/debug/node.js +1 -0
  81. data/lib/browsed/proxies/proxy-chain-server/node_modules/debug/package.json +88 -0
  82. data/lib/browsed/proxies/proxy-chain-server/node_modules/debug/src/browser.js +185 -0
  83. data/lib/browsed/proxies/proxy-chain-server/node_modules/debug/src/debug.js +202 -0
  84. data/lib/browsed/proxies/proxy-chain-server/node_modules/debug/src/index.js +10 -0
  85. data/lib/browsed/proxies/proxy-chain-server/node_modules/debug/src/inspector-log.js +15 -0
  86. data/lib/browsed/proxies/proxy-chain-server/node_modules/debug/src/node.js +248 -0
  87. data/lib/browsed/proxies/proxy-chain-server/node_modules/ms/index.js +152 -0
  88. data/lib/browsed/proxies/proxy-chain-server/node_modules/ms/license.md +21 -0
  89. data/lib/browsed/proxies/proxy-chain-server/node_modules/ms/package.json +69 -0
  90. data/lib/browsed/proxies/proxy-chain-server/node_modules/ms/readme.md +51 -0
  91. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/LICENSE +13 -0
  92. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/README.md +148 -0
  93. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/bin/portastic +65 -0
  94. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/history.md +7 -0
  95. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/index.js +4 -0
  96. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/lib/monitor.js +59 -0
  97. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/lib/portastic.js +167 -0
  98. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/LICENSE +21 -0
  99. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/README.md +677 -0
  100. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/changelog.md +1730 -0
  101. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/browser/bluebird.js +4892 -0
  102. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/browser/bluebird.min.js +31 -0
  103. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/any.js +21 -0
  104. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/assert.js +55 -0
  105. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/async.js +150 -0
  106. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/bind.js +72 -0
  107. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/bluebird.js +11 -0
  108. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/call_get.js +123 -0
  109. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/cancel.js +48 -0
  110. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/captured_trace.js +493 -0
  111. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/catch_filter.js +66 -0
  112. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/context.js +38 -0
  113. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/debuggability.js +162 -0
  114. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/direct_resolve.js +63 -0
  115. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/each.js +12 -0
  116. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/errors.js +111 -0
  117. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/es5.js +80 -0
  118. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/filter.js +12 -0
  119. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/finally.js +98 -0
  120. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/generators.js +136 -0
  121. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/join.js +107 -0
  122. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/map.js +133 -0
  123. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/method.js +44 -0
  124. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/nodeify.js +59 -0
  125. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/progress.js +76 -0
  126. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/promise.js +759 -0
  127. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/promise_array.js +142 -0
  128. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/promise_resolver.js +123 -0
  129. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/promisify.js +307 -0
  130. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/props.js +79 -0
  131. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/queue.js +90 -0
  132. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/race.js +47 -0
  133. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/reduce.js +148 -0
  134. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/schedule.js +35 -0
  135. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/settle.js +40 -0
  136. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/some.js +125 -0
  137. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/synchronous_inspection.js +94 -0
  138. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/thenables.js +84 -0
  139. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/timers.js +64 -0
  140. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/using.js +213 -0
  141. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/js/main/util.js +321 -0
  142. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/node_modules/bluebird/package.json +103 -0
  143. data/lib/browsed/proxies/proxy-chain-server/node_modules/portastic/package.json +69 -0
  144. data/lib/browsed/proxies/proxy-chain-server/node_modules/proxy-chain/CHANGELOG.md +109 -0
  145. data/lib/browsed/proxies/proxy-chain-server/node_modules/proxy-chain/LICENSE +201 -0
  146. data/lib/browsed/proxies/proxy-chain-server/node_modules/proxy-chain/README.md +278 -0
  147. data/lib/browsed/proxies/proxy-chain-server/node_modules/proxy-chain/build/anonymize_proxy.js +100 -0
  148. data/lib/browsed/proxies/proxy-chain-server/node_modules/proxy-chain/build/handler_base.js +319 -0
  149. data/lib/browsed/proxies/proxy-chain-server/node_modules/proxy-chain/build/handler_custom_response.js +96 -0
  150. data/lib/browsed/proxies/proxy-chain-server/node_modules/proxy-chain/build/handler_forward.js +173 -0
  151. data/lib/browsed/proxies/proxy-chain-server/node_modules/proxy-chain/build/handler_tunnel_chain.js +132 -0
  152. data/lib/browsed/proxies/proxy-chain-server/node_modules/proxy-chain/build/handler_tunnel_direct.js +89 -0
  153. data/lib/browsed/proxies/proxy-chain-server/node_modules/proxy-chain/build/handler_tunnel_tcp_chain.js +271 -0
  154. data/lib/browsed/proxies/proxy-chain-server/node_modules/proxy-chain/build/index.js +26 -0
  155. data/lib/browsed/proxies/proxy-chain-server/node_modules/proxy-chain/build/run_locally.js +66 -0
  156. data/lib/browsed/proxies/proxy-chain-server/node_modules/proxy-chain/build/server.js +595 -0
  157. data/lib/browsed/proxies/proxy-chain-server/node_modules/proxy-chain/build/tcp_tunnel.js +138 -0
  158. data/lib/browsed/proxies/proxy-chain-server/node_modules/proxy-chain/build/testing_tcp_service.js +37 -0
  159. data/lib/browsed/proxies/proxy-chain-server/node_modules/proxy-chain/build/tools.js +220 -0
  160. data/lib/browsed/proxies/proxy-chain-server/node_modules/proxy-chain/package.json +104 -0
  161. data/lib/browsed/proxies/proxy-chain-server/node_modules/underscore/LICENSE +23 -0
  162. data/lib/browsed/proxies/proxy-chain-server/node_modules/underscore/README.md +28 -0
  163. data/lib/browsed/proxies/proxy-chain-server/node_modules/underscore/package.json +81 -0
  164. data/lib/browsed/proxies/proxy-chain-server/node_modules/underscore/underscore-min.js +5 -0
  165. data/lib/browsed/proxies/proxy-chain-server/node_modules/underscore/underscore-min.js.map +1 -0
  166. data/lib/browsed/proxies/proxy-chain-server/node_modules/underscore/underscore.js +1692 -0
  167. data/lib/browsed/proxies/proxy-chain-server/package-lock.json +63 -0
  168. data/lib/browsed/proxies/proxy-chain-server/package.json +15 -0
  169. data/lib/browsed/proxies/proxy-chain-server/server.js +25 -0
  170. data/lib/browsed/proxies/proxy_chain.rb +36 -0
  171. data/lib/browsed/version.rb +1 -1
  172. metadata +160 -4
@@ -0,0 +1,22 @@
1
+ (The MIT License)
2
+
3
+ Copyright (c) 2011 TJ Holowaychuk <tj@vision-media.ca>
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining
6
+ a copy of this software and associated documentation files (the
7
+ 'Software'), to deal in the Software without restriction, including
8
+ without limitation the rights to use, copy, modify, merge, publish,
9
+ distribute, sublicense, and/or sell copies of the Software, and to
10
+ permit persons to whom the Software is furnished to do so, subject to
11
+ the following conditions:
12
+
13
+ The above copyright notice and this permission notice shall be
14
+ included in all copies or substantial portions of the Software.
15
+
16
+ THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
17
+ EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
18
+ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
19
+ IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
20
+ CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
21
+ TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
22
+ SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
@@ -0,0 +1,428 @@
1
+ # Commander.js
2
+
3
+
4
+ [![Build Status](https://api.travis-ci.org/tj/commander.js.svg?branch=master)](http://travis-ci.org/tj/commander.js)
5
+ [![NPM Version](http://img.shields.io/npm/v/commander.svg?style=flat)](https://www.npmjs.org/package/commander)
6
+ [![NPM Downloads](https://img.shields.io/npm/dm/commander.svg?style=flat)](https://npmcharts.com/compare/commander?minimal=true)
7
+ [![Install Size](https://packagephobia.now.sh/badge?p=commander)](https://packagephobia.now.sh/result?p=commander)
8
+ [![Join the chat at https://gitter.im/tj/commander.js](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/tj/commander.js?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
9
+
10
+ The complete solution for [node.js](http://nodejs.org) command-line interfaces, inspired by Ruby's [commander](https://github.com/commander-rb/commander).
11
+ [API documentation](http://tj.github.com/commander.js/)
12
+
13
+
14
+ ## Installation
15
+
16
+ $ npm install commander
17
+
18
+ ## Option parsing
19
+
20
+ Options with commander are defined with the `.option()` method, also serving as documentation for the options. The example below parses args and options from `process.argv`, leaving remaining args as the `program.args` array which were not consumed by options.
21
+
22
+ ```js
23
+ #!/usr/bin/env node
24
+
25
+ /**
26
+ * Module dependencies.
27
+ */
28
+
29
+ var program = require('commander');
30
+
31
+ program
32
+ .version('0.1.0')
33
+ .option('-p, --peppers', 'Add peppers')
34
+ .option('-P, --pineapple', 'Add pineapple')
35
+ .option('-b, --bbq-sauce', 'Add bbq sauce')
36
+ .option('-c, --cheese [type]', 'Add the specified type of cheese [marble]', 'marble')
37
+ .parse(process.argv);
38
+
39
+ console.log('you ordered a pizza with:');
40
+ if (program.peppers) console.log(' - peppers');
41
+ if (program.pineapple) console.log(' - pineapple');
42
+ if (program.bbqSauce) console.log(' - bbq');
43
+ console.log(' - %s cheese', program.cheese);
44
+ ```
45
+
46
+ Short flags may be passed as a single arg, for example `-abc` is equivalent to `-a -b -c`. Multi-word options such as "--template-engine" are camel-cased, becoming `program.templateEngine` etc.
47
+
48
+ Note that multi-word options starting with `--no` prefix negate the boolean value of the following word. For example, `--no-sauce` sets the value of `program.sauce` to false.
49
+
50
+ ```js
51
+ #!/usr/bin/env node
52
+
53
+ /**
54
+ * Module dependencies.
55
+ */
56
+
57
+ var program = require('commander');
58
+
59
+ program
60
+ .option('--no-sauce', 'Remove sauce')
61
+ .parse(process.argv);
62
+
63
+ console.log('you ordered a pizza');
64
+ if (program.sauce) console.log(' with sauce');
65
+ else console.log(' without sauce');
66
+ ```
67
+
68
+ To get string arguments from options you will need to use angle brackets <> for required inputs or square brackets [] for optional inputs.
69
+
70
+ e.g. ```.option('-m --myarg [myVar]', 'my super cool description')```
71
+
72
+ Then to access the input if it was passed in.
73
+
74
+ e.g. ```var myInput = program.myarg```
75
+
76
+ **NOTE**: If you pass a argument without using brackets the example above will return true and not the value passed in.
77
+
78
+
79
+ ## Version option
80
+
81
+ Calling the `version` implicitly adds the `-V` and `--version` options to the command.
82
+ When either of these options is present, the command prints the version number and exits.
83
+
84
+ $ ./examples/pizza -V
85
+ 0.0.1
86
+
87
+ If you want your program to respond to the `-v` option instead of the `-V` option, simply pass custom flags to the `version` method using the same syntax as the `option` method.
88
+
89
+ ```js
90
+ program
91
+ .version('0.0.1', '-v, --version')
92
+ ```
93
+
94
+ The version flags can be named anything, but the long option is required.
95
+
96
+ ## Command-specific options
97
+
98
+ You can attach options to a command.
99
+
100
+ ```js
101
+ #!/usr/bin/env node
102
+
103
+ var program = require('commander');
104
+
105
+ program
106
+ .command('rm <dir>')
107
+ .option('-r, --recursive', 'Remove recursively')
108
+ .action(function (dir, cmd) {
109
+ console.log('remove ' + dir + (cmd.recursive ? ' recursively' : ''))
110
+ })
111
+
112
+ program.parse(process.argv)
113
+ ```
114
+
115
+ A command's options are validated when the command is used. Any unknown options will be reported as an error. However, if an action-based command does not define an action, then the options are not validated.
116
+
117
+ ## Coercion
118
+
119
+ ```js
120
+ function range(val) {
121
+ return val.split('..').map(Number);
122
+ }
123
+
124
+ function list(val) {
125
+ return val.split(',');
126
+ }
127
+
128
+ function collect(val, memo) {
129
+ memo.push(val);
130
+ return memo;
131
+ }
132
+
133
+ function increaseVerbosity(v, total) {
134
+ return total + 1;
135
+ }
136
+
137
+ program
138
+ .version('0.1.0')
139
+ .usage('[options] <file ...>')
140
+ .option('-i, --integer <n>', 'An integer argument', parseInt)
141
+ .option('-f, --float <n>', 'A float argument', parseFloat)
142
+ .option('-r, --range <a>..<b>', 'A range', range)
143
+ .option('-l, --list <items>', 'A list', list)
144
+ .option('-o, --optional [value]', 'An optional value')
145
+ .option('-c, --collect [value]', 'A repeatable value', collect, [])
146
+ .option('-v, --verbose', 'A value that can be increased', increaseVerbosity, 0)
147
+ .parse(process.argv);
148
+
149
+ console.log(' int: %j', program.integer);
150
+ console.log(' float: %j', program.float);
151
+ console.log(' optional: %j', program.optional);
152
+ program.range = program.range || [];
153
+ console.log(' range: %j..%j', program.range[0], program.range[1]);
154
+ console.log(' list: %j', program.list);
155
+ console.log(' collect: %j', program.collect);
156
+ console.log(' verbosity: %j', program.verbose);
157
+ console.log(' args: %j', program.args);
158
+ ```
159
+
160
+ ## Regular Expression
161
+ ```js
162
+ program
163
+ .version('0.1.0')
164
+ .option('-s --size <size>', 'Pizza size', /^(large|medium|small)$/i, 'medium')
165
+ .option('-d --drink [drink]', 'Drink', /^(coke|pepsi|izze)$/i)
166
+ .parse(process.argv);
167
+
168
+ console.log(' size: %j', program.size);
169
+ console.log(' drink: %j', program.drink);
170
+ ```
171
+
172
+ ## Variadic arguments
173
+
174
+ The last argument of a command can be variadic, and only the last argument. To make an argument variadic you have to
175
+ append `...` to the argument name. Here is an example:
176
+
177
+ ```js
178
+ #!/usr/bin/env node
179
+
180
+ /**
181
+ * Module dependencies.
182
+ */
183
+
184
+ var program = require('commander');
185
+
186
+ program
187
+ .version('0.1.0')
188
+ .command('rmdir <dir> [otherDirs...]')
189
+ .action(function (dir, otherDirs) {
190
+ console.log('rmdir %s', dir);
191
+ if (otherDirs) {
192
+ otherDirs.forEach(function (oDir) {
193
+ console.log('rmdir %s', oDir);
194
+ });
195
+ }
196
+ });
197
+
198
+ program.parse(process.argv);
199
+ ```
200
+
201
+ An `Array` is used for the value of a variadic argument. This applies to `program.args` as well as the argument passed
202
+ to your action as demonstrated above.
203
+
204
+ ## Specify the argument syntax
205
+
206
+ ```js
207
+ #!/usr/bin/env node
208
+
209
+ var program = require('commander');
210
+
211
+ program
212
+ .version('0.1.0')
213
+ .arguments('<cmd> [env]')
214
+ .action(function (cmd, env) {
215
+ cmdValue = cmd;
216
+ envValue = env;
217
+ });
218
+
219
+ program.parse(process.argv);
220
+
221
+ if (typeof cmdValue === 'undefined') {
222
+ console.error('no command given!');
223
+ process.exit(1);
224
+ }
225
+ console.log('command:', cmdValue);
226
+ console.log('environment:', envValue || "no environment given");
227
+ ```
228
+ Angled brackets (e.g. `<cmd>`) indicate required input. Square brackets (e.g. `[env]`) indicate optional input.
229
+
230
+ ## Git-style sub-commands
231
+
232
+ ```js
233
+ // file: ./examples/pm
234
+ var program = require('commander');
235
+
236
+ program
237
+ .version('0.1.0')
238
+ .command('install [name]', 'install one or more packages')
239
+ .command('search [query]', 'search with optional query')
240
+ .command('list', 'list packages installed', {isDefault: true})
241
+ .parse(process.argv);
242
+ ```
243
+
244
+ When `.command()` is invoked with a description argument, no `.action(callback)` should be called to handle sub-commands, otherwise there will be an error. This tells commander that you're going to use separate executables for sub-commands, much like `git(1)` and other popular tools.
245
+ The commander will try to search the executables in the directory of the entry script (like `./examples/pm`) with the name `program-command`, like `pm-install`, `pm-search`.
246
+
247
+ Options can be passed with the call to `.command()`. Specifying `true` for `opts.noHelp` will remove the subcommand from the generated help output. Specifying `true` for `opts.isDefault` will run the subcommand if no other subcommand is specified.
248
+
249
+ If the program is designed to be installed globally, make sure the executables have proper modes, like `755`.
250
+
251
+ ### `--harmony`
252
+
253
+ You can enable `--harmony` option in two ways:
254
+ * Use `#! /usr/bin/env node --harmony` in the sub-commands scripts. Note some os version don’t support this pattern.
255
+ * Use the `--harmony` option when call the command, like `node --harmony examples/pm publish`. The `--harmony` option will be preserved when spawning sub-command process.
256
+
257
+ ## Automated --help
258
+
259
+ The help information is auto-generated based on the information commander already knows about your program, so the following `--help` info is for free:
260
+
261
+ ```
262
+ $ ./examples/pizza --help
263
+ Usage: pizza [options]
264
+
265
+ An application for pizzas ordering
266
+
267
+ Options:
268
+ -h, --help output usage information
269
+ -V, --version output the version number
270
+ -p, --peppers Add peppers
271
+ -P, --pineapple Add pineapple
272
+ -b, --bbq Add bbq sauce
273
+ -c, --cheese <type> Add the specified type of cheese [marble]
274
+ -C, --no-cheese You do not want any cheese
275
+ ```
276
+
277
+ ## Custom help
278
+
279
+ You can display arbitrary `-h, --help` information
280
+ by listening for "--help". Commander will automatically
281
+ exit once you are done so that the remainder of your program
282
+ does not execute causing undesired behaviors, for example
283
+ in the following executable "stuff" will not output when
284
+ `--help` is used.
285
+
286
+ ```js
287
+ #!/usr/bin/env node
288
+
289
+ /**
290
+ * Module dependencies.
291
+ */
292
+
293
+ var program = require('commander');
294
+
295
+ program
296
+ .version('0.1.0')
297
+ .option('-f, --foo', 'enable some foo')
298
+ .option('-b, --bar', 'enable some bar')
299
+ .option('-B, --baz', 'enable some baz');
300
+
301
+ // must be before .parse() since
302
+ // node's emit() is immediate
303
+
304
+ program.on('--help', function(){
305
+ console.log('')
306
+ console.log('Examples:');
307
+ console.log(' $ custom-help --help');
308
+ console.log(' $ custom-help -h');
309
+ });
310
+
311
+ program.parse(process.argv);
312
+
313
+ console.log('stuff');
314
+ ```
315
+
316
+ Yields the following help output when `node script-name.js -h` or `node script-name.js --help` are run:
317
+
318
+ ```
319
+ Usage: custom-help [options]
320
+
321
+ Options:
322
+ -h, --help output usage information
323
+ -V, --version output the version number
324
+ -f, --foo enable some foo
325
+ -b, --bar enable some bar
326
+ -B, --baz enable some baz
327
+
328
+ Examples:
329
+ $ custom-help --help
330
+ $ custom-help -h
331
+ ```
332
+
333
+ ## .outputHelp(cb)
334
+
335
+ Output help information without exiting.
336
+ Optional callback cb allows post-processing of help text before it is displayed.
337
+
338
+ If you want to display help by default (e.g. if no command was provided), you can use something like:
339
+
340
+ ```js
341
+ var program = require('commander');
342
+ var colors = require('colors');
343
+
344
+ program
345
+ .version('0.1.0')
346
+ .command('getstream [url]', 'get stream URL')
347
+ .parse(process.argv);
348
+
349
+ if (!process.argv.slice(2).length) {
350
+ program.outputHelp(make_red);
351
+ }
352
+
353
+ function make_red(txt) {
354
+ return colors.red(txt); //display the help text in red on the console
355
+ }
356
+ ```
357
+
358
+ ## .help(cb)
359
+
360
+ Output help information and exit immediately.
361
+ Optional callback cb allows post-processing of help text before it is displayed.
362
+
363
+
364
+ ## Custom event listeners
365
+ You can execute custom actions by listening to command and option events.
366
+
367
+ ```js
368
+ program.on('option:verbose', function () {
369
+ process.env.VERBOSE = this.verbose;
370
+ });
371
+
372
+ // error on unknown commands
373
+ program.on('command:*', function () {
374
+ console.error('Invalid command: %s\nSee --help for a list of available commands.', program.args.join(' '));
375
+ process.exit(1);
376
+ });
377
+ ```
378
+
379
+ ## Examples
380
+
381
+ ```js
382
+ var program = require('commander');
383
+
384
+ program
385
+ .version('0.1.0')
386
+ .option('-C, --chdir <path>', 'change the working directory')
387
+ .option('-c, --config <path>', 'set config path. defaults to ./deploy.conf')
388
+ .option('-T, --no-tests', 'ignore test hook');
389
+
390
+ program
391
+ .command('setup [env]')
392
+ .description('run setup commands for all envs')
393
+ .option("-s, --setup_mode [mode]", "Which setup mode to use")
394
+ .action(function(env, options){
395
+ var mode = options.setup_mode || "normal";
396
+ env = env || 'all';
397
+ console.log('setup for %s env(s) with %s mode', env, mode);
398
+ });
399
+
400
+ program
401
+ .command('exec <cmd>')
402
+ .alias('ex')
403
+ .description('execute the given remote cmd')
404
+ .option("-e, --exec_mode <mode>", "Which exec mode to use")
405
+ .action(function(cmd, options){
406
+ console.log('exec "%s" using %s mode', cmd, options.exec_mode);
407
+ }).on('--help', function() {
408
+ console.log('');
409
+ console.log('Examples:');
410
+ console.log('');
411
+ console.log(' $ deploy exec sequential');
412
+ console.log(' $ deploy exec async');
413
+ });
414
+
415
+ program
416
+ .command('*')
417
+ .action(function(env){
418
+ console.log('deploying "%s"', env);
419
+ });
420
+
421
+ program.parse(process.argv);
422
+ ```
423
+
424
+ More Demos can be found in the [examples](https://github.com/tj/commander.js/tree/master/examples) directory.
425
+
426
+ ## License
427
+
428
+ [MIT](https://github.com/tj/commander.js/blob/master/LICENSE)
@@ -0,0 +1,1224 @@
1
+ /**
2
+ * Module dependencies.
3
+ */
4
+
5
+ var EventEmitter = require('events').EventEmitter;
6
+ var spawn = require('child_process').spawn;
7
+ var path = require('path');
8
+ var dirname = path.dirname;
9
+ var basename = path.basename;
10
+ var fs = require('fs');
11
+
12
+ /**
13
+ * Inherit `Command` from `EventEmitter.prototype`.
14
+ */
15
+
16
+ require('util').inherits(Command, EventEmitter);
17
+
18
+ /**
19
+ * Expose the root command.
20
+ */
21
+
22
+ exports = module.exports = new Command();
23
+
24
+ /**
25
+ * Expose `Command`.
26
+ */
27
+
28
+ exports.Command = Command;
29
+
30
+ /**
31
+ * Expose `Option`.
32
+ */
33
+
34
+ exports.Option = Option;
35
+
36
+ /**
37
+ * Initialize a new `Option` with the given `flags` and `description`.
38
+ *
39
+ * @param {String} flags
40
+ * @param {String} description
41
+ * @api public
42
+ */
43
+
44
+ function Option(flags, description) {
45
+ this.flags = flags;
46
+ this.required = flags.indexOf('<') >= 0;
47
+ this.optional = flags.indexOf('[') >= 0;
48
+ this.bool = flags.indexOf('-no-') === -1;
49
+ flags = flags.split(/[ ,|]+/);
50
+ if (flags.length > 1 && !/^[[<]/.test(flags[1])) this.short = flags.shift();
51
+ this.long = flags.shift();
52
+ this.description = description || '';
53
+ }
54
+
55
+ /**
56
+ * Return option name.
57
+ *
58
+ * @return {String}
59
+ * @api private
60
+ */
61
+
62
+ Option.prototype.name = function() {
63
+ return this.long
64
+ .replace('--', '')
65
+ .replace('no-', '');
66
+ };
67
+
68
+ /**
69
+ * Return option name, in a camelcase format that can be used
70
+ * as a object attribute key.
71
+ *
72
+ * @return {String}
73
+ * @api private
74
+ */
75
+
76
+ Option.prototype.attributeName = function() {
77
+ return camelcase(this.name());
78
+ };
79
+
80
+ /**
81
+ * Check if `arg` matches the short or long flag.
82
+ *
83
+ * @param {String} arg
84
+ * @return {Boolean}
85
+ * @api private
86
+ */
87
+
88
+ Option.prototype.is = function(arg) {
89
+ return this.short === arg || this.long === arg;
90
+ };
91
+
92
+ /**
93
+ * Initialize a new `Command`.
94
+ *
95
+ * @param {String} name
96
+ * @api public
97
+ */
98
+
99
+ function Command(name) {
100
+ this.commands = [];
101
+ this.options = [];
102
+ this._execs = {};
103
+ this._allowUnknownOption = false;
104
+ this._args = [];
105
+ this._name = name || '';
106
+ }
107
+
108
+ /**
109
+ * Add command `name`.
110
+ *
111
+ * The `.action()` callback is invoked when the
112
+ * command `name` is specified via __ARGV__,
113
+ * and the remaining arguments are applied to the
114
+ * function for access.
115
+ *
116
+ * When the `name` is "*" an un-matched command
117
+ * will be passed as the first arg, followed by
118
+ * the rest of __ARGV__ remaining.
119
+ *
120
+ * Examples:
121
+ *
122
+ * program
123
+ * .version('0.0.1')
124
+ * .option('-C, --chdir <path>', 'change the working directory')
125
+ * .option('-c, --config <path>', 'set config path. defaults to ./deploy.conf')
126
+ * .option('-T, --no-tests', 'ignore test hook')
127
+ *
128
+ * program
129
+ * .command('setup')
130
+ * .description('run remote setup commands')
131
+ * .action(function() {
132
+ * console.log('setup');
133
+ * });
134
+ *
135
+ * program
136
+ * .command('exec <cmd>')
137
+ * .description('run the given remote command')
138
+ * .action(function(cmd) {
139
+ * console.log('exec "%s"', cmd);
140
+ * });
141
+ *
142
+ * program
143
+ * .command('teardown <dir> [otherDirs...]')
144
+ * .description('run teardown commands')
145
+ * .action(function(dir, otherDirs) {
146
+ * console.log('dir "%s"', dir);
147
+ * if (otherDirs) {
148
+ * otherDirs.forEach(function (oDir) {
149
+ * console.log('dir "%s"', oDir);
150
+ * });
151
+ * }
152
+ * });
153
+ *
154
+ * program
155
+ * .command('*')
156
+ * .description('deploy the given env')
157
+ * .action(function(env) {
158
+ * console.log('deploying "%s"', env);
159
+ * });
160
+ *
161
+ * program.parse(process.argv);
162
+ *
163
+ * @param {String} name
164
+ * @param {String} [desc] for git-style sub-commands
165
+ * @return {Command} the new command
166
+ * @api public
167
+ */
168
+
169
+ Command.prototype.command = function(name, desc, opts) {
170
+ if (typeof desc === 'object' && desc !== null) {
171
+ opts = desc;
172
+ desc = null;
173
+ }
174
+ opts = opts || {};
175
+ var args = name.split(/ +/);
176
+ var cmd = new Command(args.shift());
177
+
178
+ if (desc) {
179
+ cmd.description(desc);
180
+ this.executables = true;
181
+ this._execs[cmd._name] = true;
182
+ if (opts.isDefault) this.defaultExecutable = cmd._name;
183
+ }
184
+ cmd._noHelp = !!opts.noHelp;
185
+ this.commands.push(cmd);
186
+ cmd.parseExpectedArgs(args);
187
+ cmd.parent = this;
188
+
189
+ if (desc) return this;
190
+ return cmd;
191
+ };
192
+
193
+ /**
194
+ * Define argument syntax for the top-level command.
195
+ *
196
+ * @api public
197
+ */
198
+
199
+ Command.prototype.arguments = function(desc) {
200
+ return this.parseExpectedArgs(desc.split(/ +/));
201
+ };
202
+
203
+ /**
204
+ * Add an implicit `help [cmd]` subcommand
205
+ * which invokes `--help` for the given command.
206
+ *
207
+ * @api private
208
+ */
209
+
210
+ Command.prototype.addImplicitHelpCommand = function() {
211
+ this.command('help [cmd]', 'display help for [cmd]');
212
+ };
213
+
214
+ /**
215
+ * Parse expected `args`.
216
+ *
217
+ * For example `["[type]"]` becomes `[{ required: false, name: 'type' }]`.
218
+ *
219
+ * @param {Array} args
220
+ * @return {Command} for chaining
221
+ * @api public
222
+ */
223
+
224
+ Command.prototype.parseExpectedArgs = function(args) {
225
+ if (!args.length) return;
226
+ var self = this;
227
+ args.forEach(function(arg) {
228
+ var argDetails = {
229
+ required: false,
230
+ name: '',
231
+ variadic: false
232
+ };
233
+
234
+ switch (arg[0]) {
235
+ case '<':
236
+ argDetails.required = true;
237
+ argDetails.name = arg.slice(1, -1);
238
+ break;
239
+ case '[':
240
+ argDetails.name = arg.slice(1, -1);
241
+ break;
242
+ }
243
+
244
+ if (argDetails.name.length > 3 && argDetails.name.slice(-3) === '...') {
245
+ argDetails.variadic = true;
246
+ argDetails.name = argDetails.name.slice(0, -3);
247
+ }
248
+ if (argDetails.name) {
249
+ self._args.push(argDetails);
250
+ }
251
+ });
252
+ return this;
253
+ };
254
+
255
+ /**
256
+ * Register callback `fn` for the command.
257
+ *
258
+ * Examples:
259
+ *
260
+ * program
261
+ * .command('help')
262
+ * .description('display verbose help')
263
+ * .action(function() {
264
+ * // output help here
265
+ * });
266
+ *
267
+ * @param {Function} fn
268
+ * @return {Command} for chaining
269
+ * @api public
270
+ */
271
+
272
+ Command.prototype.action = function(fn) {
273
+ var self = this;
274
+ var listener = function(args, unknown) {
275
+ // Parse any so-far unknown options
276
+ args = args || [];
277
+ unknown = unknown || [];
278
+
279
+ var parsed = self.parseOptions(unknown);
280
+
281
+ // Output help if necessary
282
+ outputHelpIfNecessary(self, parsed.unknown);
283
+
284
+ // If there are still any unknown options, then we simply
285
+ // die, unless someone asked for help, in which case we give it
286
+ // to them, and then we die.
287
+ if (parsed.unknown.length > 0) {
288
+ self.unknownOption(parsed.unknown[0]);
289
+ }
290
+
291
+ // Leftover arguments need to be pushed back. Fixes issue #56
292
+ if (parsed.args.length) args = parsed.args.concat(args);
293
+
294
+ self._args.forEach(function(arg, i) {
295
+ if (arg.required && args[i] == null) {
296
+ self.missingArgument(arg.name);
297
+ } else if (arg.variadic) {
298
+ if (i !== self._args.length - 1) {
299
+ self.variadicArgNotLast(arg.name);
300
+ }
301
+
302
+ args[i] = args.splice(i);
303
+ }
304
+ });
305
+
306
+ // Always append ourselves to the end of the arguments,
307
+ // to make sure we match the number of arguments the user
308
+ // expects
309
+ if (self._args.length) {
310
+ args[self._args.length] = self;
311
+ } else {
312
+ args.push(self);
313
+ }
314
+
315
+ fn.apply(self, args);
316
+ };
317
+ var parent = this.parent || this;
318
+ var name = parent === this ? '*' : this._name;
319
+ parent.on('command:' + name, listener);
320
+ if (this._alias) parent.on('command:' + this._alias, listener);
321
+ return this;
322
+ };
323
+
324
+ /**
325
+ * Define option with `flags`, `description` and optional
326
+ * coercion `fn`.
327
+ *
328
+ * The `flags` string should contain both the short and long flags,
329
+ * separated by comma, a pipe or space. The following are all valid
330
+ * all will output this way when `--help` is used.
331
+ *
332
+ * "-p, --pepper"
333
+ * "-p|--pepper"
334
+ * "-p --pepper"
335
+ *
336
+ * Examples:
337
+ *
338
+ * // simple boolean defaulting to false
339
+ * program.option('-p, --pepper', 'add pepper');
340
+ *
341
+ * --pepper
342
+ * program.pepper
343
+ * // => Boolean
344
+ *
345
+ * // simple boolean defaulting to true
346
+ * program.option('-C, --no-cheese', 'remove cheese');
347
+ *
348
+ * program.cheese
349
+ * // => true
350
+ *
351
+ * --no-cheese
352
+ * program.cheese
353
+ * // => false
354
+ *
355
+ * // required argument
356
+ * program.option('-C, --chdir <path>', 'change the working directory');
357
+ *
358
+ * --chdir /tmp
359
+ * program.chdir
360
+ * // => "/tmp"
361
+ *
362
+ * // optional argument
363
+ * program.option('-c, --cheese [type]', 'add cheese [marble]');
364
+ *
365
+ * @param {String} flags
366
+ * @param {String} description
367
+ * @param {Function|*} [fn] or default
368
+ * @param {*} [defaultValue]
369
+ * @return {Command} for chaining
370
+ * @api public
371
+ */
372
+
373
+ Command.prototype.option = function(flags, description, fn, defaultValue) {
374
+ var self = this,
375
+ option = new Option(flags, description),
376
+ oname = option.name(),
377
+ name = option.attributeName();
378
+
379
+ // default as 3rd arg
380
+ if (typeof fn !== 'function') {
381
+ if (fn instanceof RegExp) {
382
+ var regex = fn;
383
+ fn = function(val, def) {
384
+ var m = regex.exec(val);
385
+ return m ? m[0] : def;
386
+ };
387
+ } else {
388
+ defaultValue = fn;
389
+ fn = null;
390
+ }
391
+ }
392
+
393
+ // preassign default value only for --no-*, [optional], or <required>
394
+ if (!option.bool || option.optional || option.required) {
395
+ // when --no-* we make sure default is true
396
+ if (!option.bool) defaultValue = true;
397
+ // preassign only if we have a default
398
+ if (defaultValue !== undefined) {
399
+ self[name] = defaultValue;
400
+ option.defaultValue = defaultValue;
401
+ }
402
+ }
403
+
404
+ // register the option
405
+ this.options.push(option);
406
+
407
+ // when it's passed assign the value
408
+ // and conditionally invoke the callback
409
+ this.on('option:' + oname, function(val) {
410
+ // coercion
411
+ if (val !== null && fn) {
412
+ val = fn(val, self[name] === undefined ? defaultValue : self[name]);
413
+ }
414
+
415
+ // unassigned or bool
416
+ if (typeof self[name] === 'boolean' || typeof self[name] === 'undefined') {
417
+ // if no value, bool true, and we have a default, then use it!
418
+ if (val == null) {
419
+ self[name] = option.bool
420
+ ? defaultValue || true
421
+ : false;
422
+ } else {
423
+ self[name] = val;
424
+ }
425
+ } else if (val !== null) {
426
+ // reassign
427
+ self[name] = val;
428
+ }
429
+ });
430
+
431
+ return this;
432
+ };
433
+
434
+ /**
435
+ * Allow unknown options on the command line.
436
+ *
437
+ * @param {Boolean} arg if `true` or omitted, no error will be thrown
438
+ * for unknown options.
439
+ * @api public
440
+ */
441
+ Command.prototype.allowUnknownOption = function(arg) {
442
+ this._allowUnknownOption = arguments.length === 0 || arg;
443
+ return this;
444
+ };
445
+
446
+ /**
447
+ * Parse `argv`, settings options and invoking commands when defined.
448
+ *
449
+ * @param {Array} argv
450
+ * @return {Command} for chaining
451
+ * @api public
452
+ */
453
+
454
+ Command.prototype.parse = function(argv) {
455
+ // implicit help
456
+ if (this.executables) this.addImplicitHelpCommand();
457
+
458
+ // store raw args
459
+ this.rawArgs = argv;
460
+
461
+ // guess name
462
+ this._name = this._name || basename(argv[1], '.js');
463
+
464
+ // github-style sub-commands with no sub-command
465
+ if (this.executables && argv.length < 3 && !this.defaultExecutable) {
466
+ // this user needs help
467
+ argv.push('--help');
468
+ }
469
+
470
+ // process argv
471
+ var parsed = this.parseOptions(this.normalize(argv.slice(2)));
472
+ var args = this.args = parsed.args;
473
+
474
+ var result = this.parseArgs(this.args, parsed.unknown);
475
+
476
+ // executable sub-commands
477
+ var name = result.args[0];
478
+
479
+ var aliasCommand = null;
480
+ // check alias of sub commands
481
+ if (name) {
482
+ aliasCommand = this.commands.filter(function(command) {
483
+ return command.alias() === name;
484
+ })[0];
485
+ }
486
+
487
+ if (this._execs[name] && typeof this._execs[name] !== 'function') {
488
+ return this.executeSubCommand(argv, args, parsed.unknown);
489
+ } else if (aliasCommand) {
490
+ // is alias of a subCommand
491
+ args[0] = aliasCommand._name;
492
+ return this.executeSubCommand(argv, args, parsed.unknown);
493
+ } else if (this.defaultExecutable) {
494
+ // use the default subcommand
495
+ args.unshift(this.defaultExecutable);
496
+ return this.executeSubCommand(argv, args, parsed.unknown);
497
+ }
498
+
499
+ return result;
500
+ };
501
+
502
+ /**
503
+ * Execute a sub-command executable.
504
+ *
505
+ * @param {Array} argv
506
+ * @param {Array} args
507
+ * @param {Array} unknown
508
+ * @api private
509
+ */
510
+
511
+ Command.prototype.executeSubCommand = function(argv, args, unknown) {
512
+ args = args.concat(unknown);
513
+
514
+ if (!args.length) this.help();
515
+ if (args[0] === 'help' && args.length === 1) this.help();
516
+
517
+ // <cmd> --help
518
+ if (args[0] === 'help') {
519
+ args[0] = args[1];
520
+ args[1] = '--help';
521
+ }
522
+
523
+ // executable
524
+ var f = argv[1];
525
+ // name of the subcommand, link `pm-install`
526
+ var bin = basename(f, path.extname(f)) + '-' + args[0];
527
+
528
+ // In case of globally installed, get the base dir where executable
529
+ // subcommand file should be located at
530
+ var baseDir;
531
+
532
+ var resolvedLink = fs.realpathSync(f);
533
+
534
+ baseDir = dirname(resolvedLink);
535
+
536
+ // prefer local `./<bin>` to bin in the $PATH
537
+ var localBin = path.join(baseDir, bin);
538
+
539
+ // whether bin file is a js script with explicit `.js` or `.ts` extension
540
+ var isExplicitJS = false;
541
+ if (exists(localBin + '.js')) {
542
+ bin = localBin + '.js';
543
+ isExplicitJS = true;
544
+ } else if (exists(localBin + '.ts')) {
545
+ bin = localBin + '.ts';
546
+ isExplicitJS = true;
547
+ } else if (exists(localBin)) {
548
+ bin = localBin;
549
+ }
550
+
551
+ args = args.slice(1);
552
+
553
+ var proc;
554
+ if (process.platform !== 'win32') {
555
+ if (isExplicitJS) {
556
+ args.unshift(bin);
557
+ // add executable arguments to spawn
558
+ args = (process.execArgv || []).concat(args);
559
+
560
+ proc = spawn(process.argv[0], args, { stdio: 'inherit', customFds: [0, 1, 2] });
561
+ } else {
562
+ proc = spawn(bin, args, { stdio: 'inherit', customFds: [0, 1, 2] });
563
+ }
564
+ } else {
565
+ args.unshift(bin);
566
+ proc = spawn(process.execPath, args, { stdio: 'inherit' });
567
+ }
568
+
569
+ var signals = ['SIGUSR1', 'SIGUSR2', 'SIGTERM', 'SIGINT', 'SIGHUP'];
570
+ signals.forEach(function(signal) {
571
+ process.on(signal, function() {
572
+ if (proc.killed === false && proc.exitCode === null) {
573
+ proc.kill(signal);
574
+ }
575
+ });
576
+ });
577
+ proc.on('close', process.exit.bind(process));
578
+ proc.on('error', function(err) {
579
+ if (err.code === 'ENOENT') {
580
+ console.error('error: %s(1) does not exist, try --help', bin);
581
+ } else if (err.code === 'EACCES') {
582
+ console.error('error: %s(1) not executable. try chmod or run with root', bin);
583
+ }
584
+ process.exit(1);
585
+ });
586
+
587
+ // Store the reference to the child process
588
+ this.runningCommand = proc;
589
+ };
590
+
591
+ /**
592
+ * Normalize `args`, splitting joined short flags. For example
593
+ * the arg "-abc" is equivalent to "-a -b -c".
594
+ * This also normalizes equal sign and splits "--abc=def" into "--abc def".
595
+ *
596
+ * @param {Array} args
597
+ * @return {Array}
598
+ * @api private
599
+ */
600
+
601
+ Command.prototype.normalize = function(args) {
602
+ var ret = [],
603
+ arg,
604
+ lastOpt,
605
+ index;
606
+
607
+ for (var i = 0, len = args.length; i < len; ++i) {
608
+ arg = args[i];
609
+ if (i > 0) {
610
+ lastOpt = this.optionFor(args[i - 1]);
611
+ }
612
+
613
+ if (arg === '--') {
614
+ // Honor option terminator
615
+ ret = ret.concat(args.slice(i));
616
+ break;
617
+ } else if (lastOpt && lastOpt.required) {
618
+ ret.push(arg);
619
+ } else if (arg.length > 1 && arg[0] === '-' && arg[1] !== '-') {
620
+ arg.slice(1).split('').forEach(function(c) {
621
+ ret.push('-' + c);
622
+ });
623
+ } else if (/^--/.test(arg) && ~(index = arg.indexOf('='))) {
624
+ ret.push(arg.slice(0, index), arg.slice(index + 1));
625
+ } else {
626
+ ret.push(arg);
627
+ }
628
+ }
629
+
630
+ return ret;
631
+ };
632
+
633
+ /**
634
+ * Parse command `args`.
635
+ *
636
+ * When listener(s) are available those
637
+ * callbacks are invoked, otherwise the "*"
638
+ * event is emitted and those actions are invoked.
639
+ *
640
+ * @param {Array} args
641
+ * @return {Command} for chaining
642
+ * @api private
643
+ */
644
+
645
+ Command.prototype.parseArgs = function(args, unknown) {
646
+ var name;
647
+
648
+ if (args.length) {
649
+ name = args[0];
650
+ if (this.listeners('command:' + name).length) {
651
+ this.emit('command:' + args.shift(), args, unknown);
652
+ } else {
653
+ this.emit('command:*', args);
654
+ }
655
+ } else {
656
+ outputHelpIfNecessary(this, unknown);
657
+
658
+ // If there were no args and we have unknown options,
659
+ // then they are extraneous and we need to error.
660
+ if (unknown.length > 0) {
661
+ this.unknownOption(unknown[0]);
662
+ }
663
+ if (this.commands.length === 0 &&
664
+ this._args.filter(function(a) { return a.required; }).length === 0) {
665
+ this.emit('command:*');
666
+ }
667
+ }
668
+
669
+ return this;
670
+ };
671
+
672
+ /**
673
+ * Return an option matching `arg` if any.
674
+ *
675
+ * @param {String} arg
676
+ * @return {Option}
677
+ * @api private
678
+ */
679
+
680
+ Command.prototype.optionFor = function(arg) {
681
+ for (var i = 0, len = this.options.length; i < len; ++i) {
682
+ if (this.options[i].is(arg)) {
683
+ return this.options[i];
684
+ }
685
+ }
686
+ };
687
+
688
+ /**
689
+ * Parse options from `argv` returning `argv`
690
+ * void of these options.
691
+ *
692
+ * @param {Array} argv
693
+ * @return {Array}
694
+ * @api public
695
+ */
696
+
697
+ Command.prototype.parseOptions = function(argv) {
698
+ var args = [],
699
+ len = argv.length,
700
+ literal,
701
+ option,
702
+ arg;
703
+
704
+ var unknownOptions = [];
705
+
706
+ // parse options
707
+ for (var i = 0; i < len; ++i) {
708
+ arg = argv[i];
709
+
710
+ // literal args after --
711
+ if (literal) {
712
+ args.push(arg);
713
+ continue;
714
+ }
715
+
716
+ if (arg === '--') {
717
+ literal = true;
718
+ continue;
719
+ }
720
+
721
+ // find matching Option
722
+ option = this.optionFor(arg);
723
+
724
+ // option is defined
725
+ if (option) {
726
+ // requires arg
727
+ if (option.required) {
728
+ arg = argv[++i];
729
+ if (arg == null) return this.optionMissingArgument(option);
730
+ this.emit('option:' + option.name(), arg);
731
+ // optional arg
732
+ } else if (option.optional) {
733
+ arg = argv[i + 1];
734
+ if (arg == null || (arg[0] === '-' && arg !== '-')) {
735
+ arg = null;
736
+ } else {
737
+ ++i;
738
+ }
739
+ this.emit('option:' + option.name(), arg);
740
+ // bool
741
+ } else {
742
+ this.emit('option:' + option.name());
743
+ }
744
+ continue;
745
+ }
746
+
747
+ // looks like an option
748
+ if (arg.length > 1 && arg[0] === '-') {
749
+ unknownOptions.push(arg);
750
+
751
+ // If the next argument looks like it might be
752
+ // an argument for this option, we pass it on.
753
+ // If it isn't, then it'll simply be ignored
754
+ if ((i + 1) < argv.length && argv[i + 1][0] !== '-') {
755
+ unknownOptions.push(argv[++i]);
756
+ }
757
+ continue;
758
+ }
759
+
760
+ // arg
761
+ args.push(arg);
762
+ }
763
+
764
+ return { args: args, unknown: unknownOptions };
765
+ };
766
+
767
+ /**
768
+ * Return an object containing options as key-value pairs
769
+ *
770
+ * @return {Object}
771
+ * @api public
772
+ */
773
+ Command.prototype.opts = function() {
774
+ var result = {},
775
+ len = this.options.length;
776
+
777
+ for (var i = 0; i < len; i++) {
778
+ var key = this.options[i].attributeName();
779
+ result[key] = key === this._versionOptionName ? this._version : this[key];
780
+ }
781
+ return result;
782
+ };
783
+
784
+ /**
785
+ * Argument `name` is missing.
786
+ *
787
+ * @param {String} name
788
+ * @api private
789
+ */
790
+
791
+ Command.prototype.missingArgument = function(name) {
792
+ console.error("error: missing required argument `%s'", name);
793
+ process.exit(1);
794
+ };
795
+
796
+ /**
797
+ * `Option` is missing an argument, but received `flag` or nothing.
798
+ *
799
+ * @param {String} option
800
+ * @param {String} flag
801
+ * @api private
802
+ */
803
+
804
+ Command.prototype.optionMissingArgument = function(option, flag) {
805
+ if (flag) {
806
+ console.error("error: option `%s' argument missing, got `%s'", option.flags, flag);
807
+ } else {
808
+ console.error("error: option `%s' argument missing", option.flags);
809
+ }
810
+ process.exit(1);
811
+ };
812
+
813
+ /**
814
+ * Unknown option `flag`.
815
+ *
816
+ * @param {String} flag
817
+ * @api private
818
+ */
819
+
820
+ Command.prototype.unknownOption = function(flag) {
821
+ if (this._allowUnknownOption) return;
822
+ console.error("error: unknown option `%s'", flag);
823
+ process.exit(1);
824
+ };
825
+
826
+ /**
827
+ * Variadic argument with `name` is not the last argument as required.
828
+ *
829
+ * @param {String} name
830
+ * @api private
831
+ */
832
+
833
+ Command.prototype.variadicArgNotLast = function(name) {
834
+ console.error("error: variadic arguments must be last `%s'", name);
835
+ process.exit(1);
836
+ };
837
+
838
+ /**
839
+ * Set the program version to `str`.
840
+ *
841
+ * This method auto-registers the "-V, --version" flag
842
+ * which will print the version number when passed.
843
+ *
844
+ * @param {String} str
845
+ * @param {String} [flags]
846
+ * @return {Command} for chaining
847
+ * @api public
848
+ */
849
+
850
+ Command.prototype.version = function(str, flags) {
851
+ if (arguments.length === 0) return this._version;
852
+ this._version = str;
853
+ flags = flags || '-V, --version';
854
+ var versionOption = new Option(flags, 'output the version number');
855
+ this._versionOptionName = versionOption.long.substr(2) || 'version';
856
+ this.options.push(versionOption);
857
+ this.on('option:' + this._versionOptionName, function() {
858
+ process.stdout.write(str + '\n');
859
+ process.exit(0);
860
+ });
861
+ return this;
862
+ };
863
+
864
+ /**
865
+ * Set the description to `str`.
866
+ *
867
+ * @param {String} str
868
+ * @param {Object} argsDescription
869
+ * @return {String|Command}
870
+ * @api public
871
+ */
872
+
873
+ Command.prototype.description = function(str, argsDescription) {
874
+ if (arguments.length === 0) return this._description;
875
+ this._description = str;
876
+ this._argsDescription = argsDescription;
877
+ return this;
878
+ };
879
+
880
+ /**
881
+ * Set an alias for the command
882
+ *
883
+ * @param {String} alias
884
+ * @return {String|Command}
885
+ * @api public
886
+ */
887
+
888
+ Command.prototype.alias = function(alias) {
889
+ var command = this;
890
+ if (this.commands.length !== 0) {
891
+ command = this.commands[this.commands.length - 1];
892
+ }
893
+
894
+ if (arguments.length === 0) return command._alias;
895
+
896
+ if (alias === command._name) throw new Error('Command alias can\'t be the same as its name');
897
+
898
+ command._alias = alias;
899
+ return this;
900
+ };
901
+
902
+ /**
903
+ * Set / get the command usage `str`.
904
+ *
905
+ * @param {String} str
906
+ * @return {String|Command}
907
+ * @api public
908
+ */
909
+
910
+ Command.prototype.usage = function(str) {
911
+ var args = this._args.map(function(arg) {
912
+ return humanReadableArgName(arg);
913
+ });
914
+
915
+ var usage = '[options]' +
916
+ (this.commands.length ? ' [command]' : '') +
917
+ (this._args.length ? ' ' + args.join(' ') : '');
918
+
919
+ if (arguments.length === 0) return this._usage || usage;
920
+ this._usage = str;
921
+
922
+ return this;
923
+ };
924
+
925
+ /**
926
+ * Get or set the name of the command
927
+ *
928
+ * @param {String} str
929
+ * @return {String|Command}
930
+ * @api public
931
+ */
932
+
933
+ Command.prototype.name = function(str) {
934
+ if (arguments.length === 0) return this._name;
935
+ this._name = str;
936
+ return this;
937
+ };
938
+
939
+ /**
940
+ * Return prepared commands.
941
+ *
942
+ * @return {Array}
943
+ * @api private
944
+ */
945
+
946
+ Command.prototype.prepareCommands = function() {
947
+ return this.commands.filter(function(cmd) {
948
+ return !cmd._noHelp;
949
+ }).map(function(cmd) {
950
+ var args = cmd._args.map(function(arg) {
951
+ return humanReadableArgName(arg);
952
+ }).join(' ');
953
+
954
+ return [
955
+ cmd._name +
956
+ (cmd._alias ? '|' + cmd._alias : '') +
957
+ (cmd.options.length ? ' [options]' : '') +
958
+ (args ? ' ' + args : ''),
959
+ cmd._description
960
+ ];
961
+ });
962
+ };
963
+
964
+ /**
965
+ * Return the largest command length.
966
+ *
967
+ * @return {Number}
968
+ * @api private
969
+ */
970
+
971
+ Command.prototype.largestCommandLength = function() {
972
+ var commands = this.prepareCommands();
973
+ return commands.reduce(function(max, command) {
974
+ return Math.max(max, command[0].length);
975
+ }, 0);
976
+ };
977
+
978
+ /**
979
+ * Return the largest option length.
980
+ *
981
+ * @return {Number}
982
+ * @api private
983
+ */
984
+
985
+ Command.prototype.largestOptionLength = function() {
986
+ var options = [].slice.call(this.options);
987
+ options.push({
988
+ flags: '-h, --help'
989
+ });
990
+ return options.reduce(function(max, option) {
991
+ return Math.max(max, option.flags.length);
992
+ }, 0);
993
+ };
994
+
995
+ /**
996
+ * Return the largest arg length.
997
+ *
998
+ * @return {Number}
999
+ * @api private
1000
+ */
1001
+
1002
+ Command.prototype.largestArgLength = function() {
1003
+ return this._args.reduce(function(max, arg) {
1004
+ return Math.max(max, arg.name.length);
1005
+ }, 0);
1006
+ };
1007
+
1008
+ /**
1009
+ * Return the pad width.
1010
+ *
1011
+ * @return {Number}
1012
+ * @api private
1013
+ */
1014
+
1015
+ Command.prototype.padWidth = function() {
1016
+ var width = this.largestOptionLength();
1017
+ if (this._argsDescription && this._args.length) {
1018
+ if (this.largestArgLength() > width) {
1019
+ width = this.largestArgLength();
1020
+ }
1021
+ }
1022
+
1023
+ if (this.commands && this.commands.length) {
1024
+ if (this.largestCommandLength() > width) {
1025
+ width = this.largestCommandLength();
1026
+ }
1027
+ }
1028
+
1029
+ return width;
1030
+ };
1031
+
1032
+ /**
1033
+ * Return help for options.
1034
+ *
1035
+ * @return {String}
1036
+ * @api private
1037
+ */
1038
+
1039
+ Command.prototype.optionHelp = function() {
1040
+ var width = this.padWidth();
1041
+
1042
+ // Append the help information
1043
+ return this.options.map(function(option) {
1044
+ return pad(option.flags, width) + ' ' + option.description +
1045
+ ((option.bool && option.defaultValue !== undefined) ? ' (default: ' + JSON.stringify(option.defaultValue) + ')' : '');
1046
+ }).concat([pad('-h, --help', width) + ' ' + 'output usage information'])
1047
+ .join('\n');
1048
+ };
1049
+
1050
+ /**
1051
+ * Return command help documentation.
1052
+ *
1053
+ * @return {String}
1054
+ * @api private
1055
+ */
1056
+
1057
+ Command.prototype.commandHelp = function() {
1058
+ if (!this.commands.length) return '';
1059
+
1060
+ var commands = this.prepareCommands();
1061
+ var width = this.padWidth();
1062
+
1063
+ return [
1064
+ 'Commands:',
1065
+ commands.map(function(cmd) {
1066
+ var desc = cmd[1] ? ' ' + cmd[1] : '';
1067
+ return (desc ? pad(cmd[0], width) : cmd[0]) + desc;
1068
+ }).join('\n').replace(/^/gm, ' '),
1069
+ ''
1070
+ ].join('\n');
1071
+ };
1072
+
1073
+ /**
1074
+ * Return program help documentation.
1075
+ *
1076
+ * @return {String}
1077
+ * @api private
1078
+ */
1079
+
1080
+ Command.prototype.helpInformation = function() {
1081
+ var desc = [];
1082
+ if (this._description) {
1083
+ desc = [
1084
+ this._description,
1085
+ ''
1086
+ ];
1087
+
1088
+ var argsDescription = this._argsDescription;
1089
+ if (argsDescription && this._args.length) {
1090
+ var width = this.padWidth();
1091
+ desc.push('Arguments:');
1092
+ desc.push('');
1093
+ this._args.forEach(function(arg) {
1094
+ desc.push(' ' + pad(arg.name, width) + ' ' + argsDescription[arg.name]);
1095
+ });
1096
+ desc.push('');
1097
+ }
1098
+ }
1099
+
1100
+ var cmdName = this._name;
1101
+ if (this._alias) {
1102
+ cmdName = cmdName + '|' + this._alias;
1103
+ }
1104
+ var usage = [
1105
+ 'Usage: ' + cmdName + ' ' + this.usage(),
1106
+ ''
1107
+ ];
1108
+
1109
+ var cmds = [];
1110
+ var commandHelp = this.commandHelp();
1111
+ if (commandHelp) cmds = [commandHelp];
1112
+
1113
+ var options = [
1114
+ 'Options:',
1115
+ '' + this.optionHelp().replace(/^/gm, ' '),
1116
+ ''
1117
+ ];
1118
+
1119
+ return usage
1120
+ .concat(desc)
1121
+ .concat(options)
1122
+ .concat(cmds)
1123
+ .join('\n');
1124
+ };
1125
+
1126
+ /**
1127
+ * Output help information for this command
1128
+ *
1129
+ * @api public
1130
+ */
1131
+
1132
+ Command.prototype.outputHelp = function(cb) {
1133
+ if (!cb) {
1134
+ cb = function(passthru) {
1135
+ return passthru;
1136
+ };
1137
+ }
1138
+ process.stdout.write(cb(this.helpInformation()));
1139
+ this.emit('--help');
1140
+ };
1141
+
1142
+ /**
1143
+ * Output help information and exit.
1144
+ *
1145
+ * @api public
1146
+ */
1147
+
1148
+ Command.prototype.help = function(cb) {
1149
+ this.outputHelp(cb);
1150
+ process.exit();
1151
+ };
1152
+
1153
+ /**
1154
+ * Camel-case the given `flag`
1155
+ *
1156
+ * @param {String} flag
1157
+ * @return {String}
1158
+ * @api private
1159
+ */
1160
+
1161
+ function camelcase(flag) {
1162
+ return flag.split('-').reduce(function(str, word) {
1163
+ return str + word[0].toUpperCase() + word.slice(1);
1164
+ });
1165
+ }
1166
+
1167
+ /**
1168
+ * Pad `str` to `width`.
1169
+ *
1170
+ * @param {String} str
1171
+ * @param {Number} width
1172
+ * @return {String}
1173
+ * @api private
1174
+ */
1175
+
1176
+ function pad(str, width) {
1177
+ var len = Math.max(0, width - str.length);
1178
+ return str + Array(len + 1).join(' ');
1179
+ }
1180
+
1181
+ /**
1182
+ * Output help information if necessary
1183
+ *
1184
+ * @param {Command} command to output help for
1185
+ * @param {Array} array of options to search for -h or --help
1186
+ * @api private
1187
+ */
1188
+
1189
+ function outputHelpIfNecessary(cmd, options) {
1190
+ options = options || [];
1191
+ for (var i = 0; i < options.length; i++) {
1192
+ if (options[i] === '--help' || options[i] === '-h') {
1193
+ cmd.outputHelp();
1194
+ process.exit(0);
1195
+ }
1196
+ }
1197
+ }
1198
+
1199
+ /**
1200
+ * Takes an argument an returns its human readable equivalent for help usage.
1201
+ *
1202
+ * @param {Object} arg
1203
+ * @return {String}
1204
+ * @api private
1205
+ */
1206
+
1207
+ function humanReadableArgName(arg) {
1208
+ var nameOutput = arg.name + (arg.variadic === true ? '...' : '');
1209
+
1210
+ return arg.required
1211
+ ? '<' + nameOutput + '>'
1212
+ : '[' + nameOutput + ']';
1213
+ }
1214
+
1215
+ // for versions before node v0.8 when there weren't `fs.existsSync`
1216
+ function exists(file) {
1217
+ try {
1218
+ if (fs.statSync(file).isFile()) {
1219
+ return true;
1220
+ }
1221
+ } catch (e) {
1222
+ return false;
1223
+ }
1224
+ }