@trayai/tray-sync-cli 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (297) hide show
  1. package/LICENSE.md +182 -0
  2. package/README.md +167 -0
  3. package/dist/api/errors.js +29 -0
  4. package/dist/api/trayClient.js +69 -0
  5. package/dist/cli.js +32 -0
  6. package/dist/commands/auth.js +103 -0
  7. package/dist/commands/env.js +534 -0
  8. package/dist/commands/init.js +115 -0
  9. package/dist/commands/project.js +175 -0
  10. package/dist/commands/promote.js +289 -0
  11. package/dist/commands/pull.js +379 -0
  12. package/dist/commands/status.js +126 -0
  13. package/dist/config/credentials.js +10 -0
  14. package/dist/config/environments.js +10 -0
  15. package/dist/config/io.js +36 -0
  16. package/dist/config/mappings.js +9 -0
  17. package/dist/config/paths.js +33 -0
  18. package/dist/config/projectConfig.js +16 -0
  19. package/dist/config/pullProgress.js +9 -0
  20. package/dist/config/state.js +9 -0
  21. package/dist/config/trayYaml.js +9 -0
  22. package/dist/config/types.js +21 -0
  23. package/dist/config/yaml.js +22 -0
  24. package/dist/lib/authDiscovery.js +76 -0
  25. package/dist/lib/checksum.js +5 -0
  26. package/dist/lib/exportStructure.js +23 -0
  27. package/dist/lib/outputFormat.js +12 -0
  28. package/dist/lib/pathContainment.js +37 -0
  29. package/dist/lib/promoteExecute.js +8 -0
  30. package/dist/lib/promoteReconstruct.js +35 -0
  31. package/dist/lib/promoteReport.js +44 -0
  32. package/dist/lib/promoteTarget.js +129 -0
  33. package/dist/lib/region.js +26 -0
  34. package/dist/lib/regionDisplay.js +11 -0
  35. package/dist/lib/regionParsing.js +12 -0
  36. package/dist/lib/scriptExtraction.js +46 -0
  37. package/dist/lib/slug.js +14 -0
  38. package/dist/lib/tokenResolution.js +19 -0
  39. package/dist/lib/uuid.js +5 -0
  40. package/dist/views/env/env.js +89 -0
  41. package/dist/views/env/shared.js +7 -0
  42. package/dist/views/init/init.js +17 -0
  43. package/dist/views/project/project.js +35 -0
  44. package/dist/views/project/shared.js +4 -0
  45. package/dist/views/promote/promote.js +44 -0
  46. package/dist/views/promote/shared.js +4 -0
  47. package/dist/views/pull/pull.js +31 -0
  48. package/dist/views/pull/shared.js +4 -0
  49. package/dist/views/shared.js +8 -0
  50. package/dist/views/status/shared.js +20 -0
  51. package/dist/views/status/status.js +23 -0
  52. package/node_modules/commander/LICENSE +22 -0
  53. package/node_modules/commander/Readme.md +1172 -0
  54. package/node_modules/commander/index.js +21 -0
  55. package/node_modules/commander/lib/argument.js +147 -0
  56. package/node_modules/commander/lib/command.js +2790 -0
  57. package/node_modules/commander/lib/error.js +36 -0
  58. package/node_modules/commander/lib/help.js +731 -0
  59. package/node_modules/commander/lib/option.js +377 -0
  60. package/node_modules/commander/lib/suggestSimilar.js +99 -0
  61. package/node_modules/commander/package-support.json +19 -0
  62. package/node_modules/commander/package.json +64 -0
  63. package/node_modules/commander/typings/index.d.ts +1113 -0
  64. package/node_modules/yaml/LICENSE +13 -0
  65. package/node_modules/yaml/README.md +172 -0
  66. package/node_modules/yaml/bin.mjs +11 -0
  67. package/node_modules/yaml/browser/dist/compose/compose-collection.js +88 -0
  68. package/node_modules/yaml/browser/dist/compose/compose-doc.js +43 -0
  69. package/node_modules/yaml/browser/dist/compose/compose-node.js +109 -0
  70. package/node_modules/yaml/browser/dist/compose/compose-scalar.js +86 -0
  71. package/node_modules/yaml/browser/dist/compose/composer.js +219 -0
  72. package/node_modules/yaml/browser/dist/compose/resolve-block-map.js +115 -0
  73. package/node_modules/yaml/browser/dist/compose/resolve-block-scalar.js +198 -0
  74. package/node_modules/yaml/browser/dist/compose/resolve-block-seq.js +49 -0
  75. package/node_modules/yaml/browser/dist/compose/resolve-end.js +37 -0
  76. package/node_modules/yaml/browser/dist/compose/resolve-flow-collection.js +207 -0
  77. package/node_modules/yaml/browser/dist/compose/resolve-flow-scalar.js +225 -0
  78. package/node_modules/yaml/browser/dist/compose/resolve-props.js +146 -0
  79. package/node_modules/yaml/browser/dist/compose/util-contains-newline.js +34 -0
  80. package/node_modules/yaml/browser/dist/compose/util-empty-scalar-position.js +26 -0
  81. package/node_modules/yaml/browser/dist/compose/util-flow-indent-check.js +15 -0
  82. package/node_modules/yaml/browser/dist/compose/util-map-includes.js +13 -0
  83. package/node_modules/yaml/browser/dist/doc/Document.js +335 -0
  84. package/node_modules/yaml/browser/dist/doc/anchors.js +71 -0
  85. package/node_modules/yaml/browser/dist/doc/applyReviver.js +55 -0
  86. package/node_modules/yaml/browser/dist/doc/createNode.js +88 -0
  87. package/node_modules/yaml/browser/dist/doc/directives.js +176 -0
  88. package/node_modules/yaml/browser/dist/errors.js +57 -0
  89. package/node_modules/yaml/browser/dist/index.js +17 -0
  90. package/node_modules/yaml/browser/dist/log.js +11 -0
  91. package/node_modules/yaml/browser/dist/nodes/Alias.js +116 -0
  92. package/node_modules/yaml/browser/dist/nodes/Collection.js +147 -0
  93. package/node_modules/yaml/browser/dist/nodes/Node.js +38 -0
  94. package/node_modules/yaml/browser/dist/nodes/Pair.js +36 -0
  95. package/node_modules/yaml/browser/dist/nodes/Scalar.js +24 -0
  96. package/node_modules/yaml/browser/dist/nodes/YAMLMap.js +144 -0
  97. package/node_modules/yaml/browser/dist/nodes/YAMLSeq.js +113 -0
  98. package/node_modules/yaml/browser/dist/nodes/addPairToJSMap.js +63 -0
  99. package/node_modules/yaml/browser/dist/nodes/identity.js +36 -0
  100. package/node_modules/yaml/browser/dist/nodes/toJS.js +37 -0
  101. package/node_modules/yaml/browser/dist/parse/cst-scalar.js +214 -0
  102. package/node_modules/yaml/browser/dist/parse/cst-stringify.js +61 -0
  103. package/node_modules/yaml/browser/dist/parse/cst-visit.js +97 -0
  104. package/node_modules/yaml/browser/dist/parse/cst.js +98 -0
  105. package/node_modules/yaml/browser/dist/parse/lexer.js +721 -0
  106. package/node_modules/yaml/browser/dist/parse/line-counter.js +39 -0
  107. package/node_modules/yaml/browser/dist/parse/parser.js +975 -0
  108. package/node_modules/yaml/browser/dist/public-api.js +102 -0
  109. package/node_modules/yaml/browser/dist/schema/Schema.js +37 -0
  110. package/node_modules/yaml/browser/dist/schema/common/map.js +17 -0
  111. package/node_modules/yaml/browser/dist/schema/common/null.js +15 -0
  112. package/node_modules/yaml/browser/dist/schema/common/seq.js +17 -0
  113. package/node_modules/yaml/browser/dist/schema/common/string.js +14 -0
  114. package/node_modules/yaml/browser/dist/schema/core/bool.js +19 -0
  115. package/node_modules/yaml/browser/dist/schema/core/float.js +43 -0
  116. package/node_modules/yaml/browser/dist/schema/core/int.js +38 -0
  117. package/node_modules/yaml/browser/dist/schema/core/schema.js +23 -0
  118. package/node_modules/yaml/browser/dist/schema/json/schema.js +62 -0
  119. package/node_modules/yaml/browser/dist/schema/tags.js +96 -0
  120. package/node_modules/yaml/browser/dist/schema/yaml-1.1/binary.js +58 -0
  121. package/node_modules/yaml/browser/dist/schema/yaml-1.1/bool.js +26 -0
  122. package/node_modules/yaml/browser/dist/schema/yaml-1.1/float.js +46 -0
  123. package/node_modules/yaml/browser/dist/schema/yaml-1.1/int.js +71 -0
  124. package/node_modules/yaml/browser/dist/schema/yaml-1.1/merge.js +67 -0
  125. package/node_modules/yaml/browser/dist/schema/yaml-1.1/omap.js +74 -0
  126. package/node_modules/yaml/browser/dist/schema/yaml-1.1/pairs.js +78 -0
  127. package/node_modules/yaml/browser/dist/schema/yaml-1.1/schema.js +39 -0
  128. package/node_modules/yaml/browser/dist/schema/yaml-1.1/set.js +93 -0
  129. package/node_modules/yaml/browser/dist/schema/yaml-1.1/timestamp.js +101 -0
  130. package/node_modules/yaml/browser/dist/stringify/foldFlowLines.js +146 -0
  131. package/node_modules/yaml/browser/dist/stringify/stringify.js +129 -0
  132. package/node_modules/yaml/browser/dist/stringify/stringifyCollection.js +153 -0
  133. package/node_modules/yaml/browser/dist/stringify/stringifyComment.js +20 -0
  134. package/node_modules/yaml/browser/dist/stringify/stringifyDocument.js +85 -0
  135. package/node_modules/yaml/browser/dist/stringify/stringifyNumber.js +25 -0
  136. package/node_modules/yaml/browser/dist/stringify/stringifyPair.js +150 -0
  137. package/node_modules/yaml/browser/dist/stringify/stringifyString.js +336 -0
  138. package/node_modules/yaml/browser/dist/util.js +11 -0
  139. package/node_modules/yaml/browser/dist/visit.js +233 -0
  140. package/node_modules/yaml/browser/index.js +5 -0
  141. package/node_modules/yaml/browser/package.json +3 -0
  142. package/node_modules/yaml/dist/cli.d.ts +8 -0
  143. package/node_modules/yaml/dist/cli.mjs +201 -0
  144. package/node_modules/yaml/dist/compose/compose-collection.d.ts +11 -0
  145. package/node_modules/yaml/dist/compose/compose-collection.js +90 -0
  146. package/node_modules/yaml/dist/compose/compose-doc.d.ts +7 -0
  147. package/node_modules/yaml/dist/compose/compose-doc.js +45 -0
  148. package/node_modules/yaml/dist/compose/compose-node.d.ts +29 -0
  149. package/node_modules/yaml/dist/compose/compose-node.js +112 -0
  150. package/node_modules/yaml/dist/compose/compose-scalar.d.ts +5 -0
  151. package/node_modules/yaml/dist/compose/compose-scalar.js +88 -0
  152. package/node_modules/yaml/dist/compose/composer.d.ts +63 -0
  153. package/node_modules/yaml/dist/compose/composer.js +224 -0
  154. package/node_modules/yaml/dist/compose/resolve-block-map.d.ts +6 -0
  155. package/node_modules/yaml/dist/compose/resolve-block-map.js +117 -0
  156. package/node_modules/yaml/dist/compose/resolve-block-scalar.d.ts +11 -0
  157. package/node_modules/yaml/dist/compose/resolve-block-scalar.js +200 -0
  158. package/node_modules/yaml/dist/compose/resolve-block-seq.d.ts +6 -0
  159. package/node_modules/yaml/dist/compose/resolve-block-seq.js +51 -0
  160. package/node_modules/yaml/dist/compose/resolve-end.d.ts +6 -0
  161. package/node_modules/yaml/dist/compose/resolve-end.js +39 -0
  162. package/node_modules/yaml/dist/compose/resolve-flow-collection.d.ts +7 -0
  163. package/node_modules/yaml/dist/compose/resolve-flow-collection.js +209 -0
  164. package/node_modules/yaml/dist/compose/resolve-flow-scalar.d.ts +10 -0
  165. package/node_modules/yaml/dist/compose/resolve-flow-scalar.js +227 -0
  166. package/node_modules/yaml/dist/compose/resolve-props.d.ts +23 -0
  167. package/node_modules/yaml/dist/compose/resolve-props.js +148 -0
  168. package/node_modules/yaml/dist/compose/util-contains-newline.d.ts +2 -0
  169. package/node_modules/yaml/dist/compose/util-contains-newline.js +36 -0
  170. package/node_modules/yaml/dist/compose/util-empty-scalar-position.d.ts +2 -0
  171. package/node_modules/yaml/dist/compose/util-empty-scalar-position.js +28 -0
  172. package/node_modules/yaml/dist/compose/util-flow-indent-check.d.ts +3 -0
  173. package/node_modules/yaml/dist/compose/util-flow-indent-check.js +17 -0
  174. package/node_modules/yaml/dist/compose/util-map-includes.d.ts +4 -0
  175. package/node_modules/yaml/dist/compose/util-map-includes.js +15 -0
  176. package/node_modules/yaml/dist/doc/Document.d.ts +141 -0
  177. package/node_modules/yaml/dist/doc/Document.js +337 -0
  178. package/node_modules/yaml/dist/doc/anchors.d.ts +24 -0
  179. package/node_modules/yaml/dist/doc/anchors.js +76 -0
  180. package/node_modules/yaml/dist/doc/applyReviver.d.ts +9 -0
  181. package/node_modules/yaml/dist/doc/applyReviver.js +57 -0
  182. package/node_modules/yaml/dist/doc/createNode.d.ts +17 -0
  183. package/node_modules/yaml/dist/doc/createNode.js +90 -0
  184. package/node_modules/yaml/dist/doc/directives.d.ts +49 -0
  185. package/node_modules/yaml/dist/doc/directives.js +178 -0
  186. package/node_modules/yaml/dist/errors.d.ts +21 -0
  187. package/node_modules/yaml/dist/errors.js +62 -0
  188. package/node_modules/yaml/dist/index.d.ts +25 -0
  189. package/node_modules/yaml/dist/index.js +50 -0
  190. package/node_modules/yaml/dist/log.d.ts +3 -0
  191. package/node_modules/yaml/dist/log.js +19 -0
  192. package/node_modules/yaml/dist/nodes/Alias.d.ts +29 -0
  193. package/node_modules/yaml/dist/nodes/Alias.js +118 -0
  194. package/node_modules/yaml/dist/nodes/Collection.d.ts +73 -0
  195. package/node_modules/yaml/dist/nodes/Collection.js +151 -0
  196. package/node_modules/yaml/dist/nodes/Node.d.ts +53 -0
  197. package/node_modules/yaml/dist/nodes/Node.js +40 -0
  198. package/node_modules/yaml/dist/nodes/Pair.d.ts +22 -0
  199. package/node_modules/yaml/dist/nodes/Pair.js +39 -0
  200. package/node_modules/yaml/dist/nodes/Scalar.d.ts +47 -0
  201. package/node_modules/yaml/dist/nodes/Scalar.js +27 -0
  202. package/node_modules/yaml/dist/nodes/YAMLMap.d.ts +53 -0
  203. package/node_modules/yaml/dist/nodes/YAMLMap.js +147 -0
  204. package/node_modules/yaml/dist/nodes/YAMLSeq.d.ts +60 -0
  205. package/node_modules/yaml/dist/nodes/YAMLSeq.js +115 -0
  206. package/node_modules/yaml/dist/nodes/addPairToJSMap.d.ts +4 -0
  207. package/node_modules/yaml/dist/nodes/addPairToJSMap.js +65 -0
  208. package/node_modules/yaml/dist/nodes/identity.d.ts +23 -0
  209. package/node_modules/yaml/dist/nodes/identity.js +53 -0
  210. package/node_modules/yaml/dist/nodes/toJS.d.ts +29 -0
  211. package/node_modules/yaml/dist/nodes/toJS.js +39 -0
  212. package/node_modules/yaml/dist/options.d.ts +350 -0
  213. package/node_modules/yaml/dist/parse/cst-scalar.d.ts +64 -0
  214. package/node_modules/yaml/dist/parse/cst-scalar.js +218 -0
  215. package/node_modules/yaml/dist/parse/cst-stringify.d.ts +8 -0
  216. package/node_modules/yaml/dist/parse/cst-stringify.js +63 -0
  217. package/node_modules/yaml/dist/parse/cst-visit.d.ts +39 -0
  218. package/node_modules/yaml/dist/parse/cst-visit.js +99 -0
  219. package/node_modules/yaml/dist/parse/cst.d.ts +109 -0
  220. package/node_modules/yaml/dist/parse/cst.js +112 -0
  221. package/node_modules/yaml/dist/parse/lexer.d.ts +87 -0
  222. package/node_modules/yaml/dist/parse/lexer.js +723 -0
  223. package/node_modules/yaml/dist/parse/line-counter.d.ts +22 -0
  224. package/node_modules/yaml/dist/parse/line-counter.js +41 -0
  225. package/node_modules/yaml/dist/parse/parser.d.ts +84 -0
  226. package/node_modules/yaml/dist/parse/parser.js +980 -0
  227. package/node_modules/yaml/dist/public-api.d.ts +44 -0
  228. package/node_modules/yaml/dist/public-api.js +107 -0
  229. package/node_modules/yaml/dist/schema/Schema.d.ts +17 -0
  230. package/node_modules/yaml/dist/schema/Schema.js +39 -0
  231. package/node_modules/yaml/dist/schema/common/map.d.ts +2 -0
  232. package/node_modules/yaml/dist/schema/common/map.js +19 -0
  233. package/node_modules/yaml/dist/schema/common/null.d.ts +4 -0
  234. package/node_modules/yaml/dist/schema/common/null.js +17 -0
  235. package/node_modules/yaml/dist/schema/common/seq.d.ts +2 -0
  236. package/node_modules/yaml/dist/schema/common/seq.js +19 -0
  237. package/node_modules/yaml/dist/schema/common/string.d.ts +2 -0
  238. package/node_modules/yaml/dist/schema/common/string.js +16 -0
  239. package/node_modules/yaml/dist/schema/core/bool.d.ts +4 -0
  240. package/node_modules/yaml/dist/schema/core/bool.js +21 -0
  241. package/node_modules/yaml/dist/schema/core/float.d.ts +4 -0
  242. package/node_modules/yaml/dist/schema/core/float.js +47 -0
  243. package/node_modules/yaml/dist/schema/core/int.d.ts +4 -0
  244. package/node_modules/yaml/dist/schema/core/int.js +42 -0
  245. package/node_modules/yaml/dist/schema/core/schema.d.ts +1 -0
  246. package/node_modules/yaml/dist/schema/core/schema.js +25 -0
  247. package/node_modules/yaml/dist/schema/json/schema.d.ts +2 -0
  248. package/node_modules/yaml/dist/schema/json/schema.js +64 -0
  249. package/node_modules/yaml/dist/schema/json-schema.d.ts +69 -0
  250. package/node_modules/yaml/dist/schema/tags.d.ts +48 -0
  251. package/node_modules/yaml/dist/schema/tags.js +99 -0
  252. package/node_modules/yaml/dist/schema/types.d.ts +92 -0
  253. package/node_modules/yaml/dist/schema/yaml-1.1/binary.d.ts +2 -0
  254. package/node_modules/yaml/dist/schema/yaml-1.1/binary.js +70 -0
  255. package/node_modules/yaml/dist/schema/yaml-1.1/bool.d.ts +7 -0
  256. package/node_modules/yaml/dist/schema/yaml-1.1/bool.js +29 -0
  257. package/node_modules/yaml/dist/schema/yaml-1.1/float.d.ts +4 -0
  258. package/node_modules/yaml/dist/schema/yaml-1.1/float.js +50 -0
  259. package/node_modules/yaml/dist/schema/yaml-1.1/int.d.ts +5 -0
  260. package/node_modules/yaml/dist/schema/yaml-1.1/int.js +76 -0
  261. package/node_modules/yaml/dist/schema/yaml-1.1/merge.d.ts +9 -0
  262. package/node_modules/yaml/dist/schema/yaml-1.1/merge.js +71 -0
  263. package/node_modules/yaml/dist/schema/yaml-1.1/omap.d.ts +22 -0
  264. package/node_modules/yaml/dist/schema/yaml-1.1/omap.js +77 -0
  265. package/node_modules/yaml/dist/schema/yaml-1.1/pairs.d.ts +10 -0
  266. package/node_modules/yaml/dist/schema/yaml-1.1/pairs.js +82 -0
  267. package/node_modules/yaml/dist/schema/yaml-1.1/schema.d.ts +1 -0
  268. package/node_modules/yaml/dist/schema/yaml-1.1/schema.js +41 -0
  269. package/node_modules/yaml/dist/schema/yaml-1.1/set.d.ts +28 -0
  270. package/node_modules/yaml/dist/schema/yaml-1.1/set.js +96 -0
  271. package/node_modules/yaml/dist/schema/yaml-1.1/timestamp.d.ts +6 -0
  272. package/node_modules/yaml/dist/schema/yaml-1.1/timestamp.js +105 -0
  273. package/node_modules/yaml/dist/stringify/foldFlowLines.d.ts +34 -0
  274. package/node_modules/yaml/dist/stringify/foldFlowLines.js +151 -0
  275. package/node_modules/yaml/dist/stringify/stringify.d.ts +21 -0
  276. package/node_modules/yaml/dist/stringify/stringify.js +132 -0
  277. package/node_modules/yaml/dist/stringify/stringifyCollection.d.ts +17 -0
  278. package/node_modules/yaml/dist/stringify/stringifyCollection.js +155 -0
  279. package/node_modules/yaml/dist/stringify/stringifyComment.d.ts +10 -0
  280. package/node_modules/yaml/dist/stringify/stringifyComment.js +24 -0
  281. package/node_modules/yaml/dist/stringify/stringifyDocument.d.ts +4 -0
  282. package/node_modules/yaml/dist/stringify/stringifyDocument.js +87 -0
  283. package/node_modules/yaml/dist/stringify/stringifyNumber.d.ts +2 -0
  284. package/node_modules/yaml/dist/stringify/stringifyNumber.js +27 -0
  285. package/node_modules/yaml/dist/stringify/stringifyPair.d.ts +3 -0
  286. package/node_modules/yaml/dist/stringify/stringifyPair.js +152 -0
  287. package/node_modules/yaml/dist/stringify/stringifyString.d.ts +9 -0
  288. package/node_modules/yaml/dist/stringify/stringifyString.js +338 -0
  289. package/node_modules/yaml/dist/test-events.d.ts +4 -0
  290. package/node_modules/yaml/dist/test-events.js +134 -0
  291. package/node_modules/yaml/dist/util.d.ts +16 -0
  292. package/node_modules/yaml/dist/util.js +28 -0
  293. package/node_modules/yaml/dist/visit.d.ts +102 -0
  294. package/node_modules/yaml/dist/visit.js +236 -0
  295. package/node_modules/yaml/package.json +97 -0
  296. package/node_modules/yaml/util.js +2 -0
  297. package/package.json +42 -0
@@ -0,0 +1,21 @@
1
+ import { Argument } from './lib/argument.js';
2
+ import { Command } from './lib/command.js';
3
+ import { CommanderError, InvalidArgumentError } from './lib/error.js';
4
+ import { Help } from './lib/help.js';
5
+ import { Option } from './lib/option.js';
6
+
7
+ export const program = new Command();
8
+
9
+ export const createCommand = (name) => new Command(name);
10
+ export const createOption = (flags, description) =>
11
+ new Option(flags, description);
12
+ export const createArgument = (name, description) =>
13
+ new Argument(name, description);
14
+
15
+ /**
16
+ * Expose classes
17
+ */
18
+
19
+ export { Command, Option, Argument, Help };
20
+ export { CommanderError, InvalidArgumentError };
21
+ export { InvalidArgumentError as InvalidOptionArgumentError }; // Deprecated
@@ -0,0 +1,147 @@
1
+ import { InvalidArgumentError } from './error.js';
2
+
3
+ export class Argument {
4
+ /**
5
+ * Initialize a new command argument with the given name and description.
6
+ * The default is that the argument is required, and you can explicitly
7
+ * indicate this with <> around the name. Put [] around the name for an optional argument.
8
+ *
9
+ * @param {string} name
10
+ * @param {string} [description]
11
+ */
12
+
13
+ constructor(name, description) {
14
+ this.description = description || '';
15
+ this.variadic = false;
16
+ this.parseArg = undefined;
17
+ this.defaultValue = undefined;
18
+ this.defaultValueDescription = undefined;
19
+ this.argChoices = undefined;
20
+
21
+ switch (name[0]) {
22
+ case '<': // e.g. <required>
23
+ this.required = true;
24
+ this._name = name.slice(1, -1);
25
+ break;
26
+ case '[': // e.g. [optional]
27
+ this.required = false;
28
+ this._name = name.slice(1, -1);
29
+ break;
30
+ default:
31
+ this.required = true;
32
+ this._name = name;
33
+ break;
34
+ }
35
+
36
+ if (this._name.endsWith('...')) {
37
+ this.variadic = true;
38
+ this._name = this._name.slice(0, -3);
39
+ }
40
+ }
41
+
42
+ /**
43
+ * Return argument name.
44
+ *
45
+ * @return {string}
46
+ */
47
+
48
+ name() {
49
+ return this._name;
50
+ }
51
+
52
+ /**
53
+ * @package
54
+ */
55
+
56
+ _collectValue(value, previous) {
57
+ if (previous === this.defaultValue || !Array.isArray(previous)) {
58
+ return [value];
59
+ }
60
+
61
+ previous.push(value);
62
+ return previous;
63
+ }
64
+
65
+ /**
66
+ * Set the default value, and optionally supply the description to be displayed in the help.
67
+ *
68
+ * @param {*} value
69
+ * @param {string} [description]
70
+ * @return {Argument}
71
+ */
72
+
73
+ default(value, description) {
74
+ this.defaultValue = value;
75
+ this.defaultValueDescription = description;
76
+ return this;
77
+ }
78
+
79
+ /**
80
+ * Set the custom handler for processing CLI command arguments into argument values.
81
+ *
82
+ * @param {Function} [fn]
83
+ * @return {Argument}
84
+ */
85
+
86
+ argParser(fn) {
87
+ this.parseArg = fn;
88
+ return this;
89
+ }
90
+
91
+ /**
92
+ * Only allow argument value to be one of choices.
93
+ *
94
+ * @param {string[]} values
95
+ * @return {Argument}
96
+ */
97
+
98
+ choices(values) {
99
+ this.argChoices = values.slice();
100
+ this.parseArg = (arg, previous) => {
101
+ if (!this.argChoices.includes(arg)) {
102
+ throw new InvalidArgumentError(
103
+ `Allowed choices are ${this.argChoices.join(', ')}.`,
104
+ );
105
+ }
106
+ if (this.variadic) {
107
+ return this._collectValue(arg, previous);
108
+ }
109
+ return arg;
110
+ };
111
+ return this;
112
+ }
113
+
114
+ /**
115
+ * Make argument required.
116
+ *
117
+ * @returns {Argument}
118
+ */
119
+ argRequired() {
120
+ this.required = true;
121
+ return this;
122
+ }
123
+
124
+ /**
125
+ * Make argument optional.
126
+ *
127
+ * @returns {Argument}
128
+ */
129
+ argOptional() {
130
+ this.required = false;
131
+ return this;
132
+ }
133
+ }
134
+
135
+ /**
136
+ * Takes an argument and returns its human readable equivalent for help usage.
137
+ *
138
+ * @param {Argument} arg
139
+ * @return {string}
140
+ * @private
141
+ */
142
+
143
+ export function humanReadableArgName(arg) {
144
+ const nameOutput = arg.name() + (arg.variadic === true ? '...' : '');
145
+
146
+ return arg.required ? '<' + nameOutput + '>' : '[' + nameOutput + ']';
147
+ }