@decaf-ts/cli 0.0.14 → 0.3.2
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.
- package/README.md +29 -234
- package/dist/cli.cjs +245 -0
- package/dist/cli.esm.cjs +240 -0
- package/lib/CliWrapper.cjs +1 -0
- package/lib/bin/cli.cjs +30 -0
- package/lib/constants.cjs +1 -0
- package/lib/demo/cli-module.cjs +1 -0
- package/lib/esm/CliWrapper.js +1 -2
- package/lib/esm/bin/cli.js +27 -0
- package/lib/esm/constants.js +1 -2
- package/lib/esm/demo/cli-module.js +1 -2
- package/lib/esm/index.d.ts +1 -1
- package/lib/esm/index.js +2 -3
- package/lib/esm/types.js +1 -2
- package/lib/esm/utils.js +1 -2
- package/lib/index.cjs +2 -1
- package/lib/index.d.ts +1 -1
- package/lib/types.cjs +1 -0
- package/lib/utils.cjs +1 -0
- package/package.json +31 -36
- package/lib/cli.cjs +0 -25
- package/lib/esm/cli.js +0 -28
- /package/lib/{cli.d.ts → bin/cli.d.ts} +0 -0
- /package/lib/esm/{cli.d.ts → bin/cli.d.ts} +0 -0
package/README.md
CHANGED
|
@@ -1,23 +1,27 @@
|
|
|
1
1
|
|
|
2
|
-
## Decaf-ts cli
|
|
3
2
|
|
|
3
|
+
## Decaf-ts cli
|
|
4
4
|
|
|
5
|
+
Exposes global cli tool that consumes other modules' clis under a standard command `decaf`
|
|
5
6
|
|
|
6
7
|
|
|
7
8
|
|
|
8
9
|
|
|
9
|
-
|
|
10
|
-
[](https://github.com/decaf-ts/cli/actions/workflows/nodejs-build-prod.yaml)
|
|
12
|
+
[](https://github.com/decaf-ts/cli/actions/workflows/codeql-analysis.yml)[](https://github.com/decaf-ts/cli/actions/workflows/snyk-analysis.yaml)
|
|
13
|
+
[](https://github.com/decaf-ts/cli/actions/workflows/pages.yaml)
|
|
14
|
+
[](https://github.com/decaf-ts/cli/actions/workflows/release-on-tag.yaml)
|
|
11
15
|
|
|
12
16
|
|
|
13
17
|
|
|
14
18
|
|
|
15
19
|
|
|
16
20
|
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
|
|
24
|
+
|
|
21
25
|
|
|
22
26
|
|
|
23
27
|
|
|
@@ -27,245 +31,38 @@
|
|
|
27
31
|
|
|
28
32
|
|
|
29
33
|
|
|
30
|
-
|
|
34
|
+
Documentation available [here](https://decaf-ts.github.io/cli/)
|
|
31
35
|
|
|
32
|
-
|
|
36
|
+
### Description
|
|
33
37
|
|
|
34
|
-
Defines a 'way' to write jsDocs to optimize the output
|
|
35
38
|
|
|
36
|
-
Optimized for github in terms of badges. CI is equivalent between Gitlab and Github.
|
|
37
39
|
|
|
38
|
-
|
|
40
|
+
### How to Use
|
|
39
41
|
|
|
40
|
-
|
|
42
|
+
- [Initial Setup](../../workdocs/tutorials/For%20Developers.md#_initial-setup_)
|
|
43
|
+
- [Installation](../../workdocs/tutorials/For%20Developers.md#installation)
|
|
41
44
|
|
|
42
|
-
### ***Initial Setup***
|
|
43
45
|
|
|
44
|
-
#### if you use github
|
|
45
46
|
|
|
46
|
-
create a new project using this one as a template.
|
|
47
47
|
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
#### If your project has private dependencies or publishes to private npm registries, create an `.npmrc` containing:
|
|
48
|
+
### Related
|
|
51
49
|
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
```
|
|
50
|
+
[](https://github.com/decaf-ts/decaf-ts)
|
|
51
|
+
[](https://github.com/decaf-ts/for-fabric)
|
|
52
|
+
[](https://github.com/decaf-ts/for-angular)
|
|
53
|
+
[](https://github.com/decaf-ts/decorator-validation)
|
|
54
|
+
[](https://github.com/decaf-ts/db-decorators)
|
|
55
|
+
[](https://github.com/decaf-ts/utils)
|
|
59
56
|
|
|
60
|
-
Changing:
|
|
61
|
-
- <ADDRESS> to `gitlab` or `github` (or other);
|
|
62
|
-
- <DOMAIN> to your domain if any (if you are using plain gitlab or github use empty and take care to remove the extra `.`);
|
|
63
|
-
- <GROUP_ID> to your project's group id (if any). otherwise remove this line
|
|
64
|
-
- <PROJECT_ID> to your project's id
|
|
65
57
|
|
|
66
|
-
|
|
58
|
+
### Social
|
|
67
59
|
|
|
68
|
-
|
|
60
|
+
[](https://www.linkedin.com/in/decaf-ts/)
|
|
69
61
|
|
|
70
|
-
Run `npm install` (or `npm run do-install` if you have private dependencies and a `.token` file) to install the dependencies:
|
|
71
62
|
|
|
72
|
-
If this is the first time you are running this command it will also:
|
|
73
|
-
- update this repository's dependencies to their latest version;
|
|
74
|
-
- creates a `.token` file which you can leave empty unless you have private dependencies or publish to private registries
|
|
75
|
-
- delete this 'first run script' file and npm call from the `package.json`;
|
|
76
|
-
- try to commit the updated `package.json` and deleted files (having ssh access helps here);
|
|
77
|
-
## Linting
|
|
78
|
-
|
|
79
|
-
This repo comes with eslint + prettier preconfigured to the default standards
|
|
80
|
-
## Testing
|
|
81
|
-
|
|
82
|
-
Preconfigured Jest based testing:
|
|
83
|
-
|
|
84
|
-
- unit tests under the `tests/unit` folder;
|
|
85
|
-
- include a default bundle test (helps with circular dependencies and such);
|
|
86
|
-
- integration tests under the `tests/integration` folder;
|
|
87
|
-
- stores converage results under `workdocs/coverage`;
|
|
88
|
-
- publishes coverage result to docs;
|
|
89
|
-
- ignores `cli.ts` from coverage since that is an executable file;
|
|
90
|
-
- defines the coverage threshold in `jest.config.ts`;
|
|
91
|
-
### Releases
|
|
92
|
-
|
|
93
|
-
This repository automates releases in the following manner:
|
|
94
|
-
|
|
95
|
-
- run `npm run release -- <major|minor|patch|version> <message>`:
|
|
96
|
-
- if arguments are missing you will be prompted for them;
|
|
97
|
-
- it will run `npm run prepare-release` npm script;
|
|
98
|
-
- it will commit all changes;
|
|
99
|
-
- it will push the new tag;
|
|
100
|
-
|
|
101
|
-
If publishing to a private repo's npm registry, make sure you add to your `package.json`:
|
|
102
|
-
|
|
103
|
-
```json
|
|
104
|
-
{
|
|
105
|
-
"publishConfig": {
|
|
106
|
-
"<SCOPE>:registry": " https://<REGISTRY>/api/v4/projects/<PROJECT_ID>/packages/npm/"
|
|
107
|
-
}
|
|
108
|
-
}
|
|
109
|
-
```
|
|
110
|
-
|
|
111
|
-
Where:
|
|
112
|
-
|
|
113
|
-
- `<SCOPE>` - Is the scope of your package;
|
|
114
|
-
- `<REGISTRY>` - your registry host;
|
|
115
|
-
- `<PROJECT_ID>` - you project ID number (easy to grab via UI in gitlab or by
|
|
116
|
-
running `$("meta[name=octolytics-dimension-repository_id]").getAttribute('content')` in the repository page in github)
|
|
117
|
-
;
|
|
118
|
-
|
|
119
|
-
### Publishing
|
|
120
|
-
|
|
121
|
-
Unless the `-no-ci` flag is passed in the commit message to the `npm run release` command, publishing will be handled
|
|
122
|
-
automatically by github/gitlab (triggered by the tag).
|
|
123
|
-
|
|
124
|
-
When the `-no-ci` flag is passed then you can:
|
|
125
|
-
|
|
126
|
-
- run `npm run publish`. This command assumes :
|
|
127
|
-
- you have previously run the `npm run release`;
|
|
128
|
-
- you have you publishing properly configured in `npmrc` and `package.json`;
|
|
129
|
-
- The token for any special access required is stored in the `.token` file;
|
|
130
|
-
|
|
131
|
-
## Continuous Integration/Deployment
|
|
132
|
-
|
|
133
|
-
While the implementationfor gitlab and github are not perfectly matched, they are perfectly usable.
|
|
134
|
-
|
|
135
|
-
The template comes with ci/cd for :
|
|
136
|
-
- gitlab (with caching for performance):
|
|
137
|
-
- stages:
|
|
138
|
-
- dependencies: Installs dependencies (on `package-lock.json` changes, caches node modules);
|
|
139
|
-
- build: builds the code (on `src/*` changes, caches `lib` and `dist`);
|
|
140
|
-
- test: tests the code (on `src/*`, `test/*` changes, caches `workdocs/{resources, badges, coverage}`);
|
|
141
|
-
- deploy:
|
|
142
|
-
- deploys to package registry on a tag (public|private);
|
|
143
|
-
- deploys docker image to docker registry (private);
|
|
144
|
-
- Deploys the documentation to the repository pages;
|
|
145
|
-
- github:
|
|
146
|
-
- jest-test: standard `install -> build -> test` loop;
|
|
147
|
-
- jest-coverage: extracts coverage from the tests;
|
|
148
|
-
- codeql-analysis: Code quality analisys;
|
|
149
|
-
- pages: builds the documentation and deploys to github pages
|
|
150
|
-
- release-on-tag: issues a release when the tag does not contain `-no-ci` string
|
|
151
|
-
- publish-on-release: publishes to package registry when the tag does not contain the `-no-ci` string
|
|
152
|
-
- Requires Variables:
|
|
153
|
-
- CONSECUTIVE_ACTION_TRIGGER: secret to enable actions to trigger other actions;
|
|
154
|
-
- NPM_TOKEN: npm/docker registry token
|
|
155
|
-
## Considerations
|
|
156
|
-
- Setup for a linux based environment (Sorry windows users. use WSL... or just change already);
|
|
157
|
-
- Setup for node 20, but will work at least with 16;
|
|
158
|
-
- Requires docker to build documentation (drawings and PlantUML)
|
|
159
|
-
## Documentation
|
|
160
|
-
|
|
161
|
-
The repository proposes a way to generate documentation that while still not ideal, produces verys consitest results.
|
|
162
|
-
|
|
163
|
-
In the code you see an example on how to properly document each code object, but the overall structure is:
|
|
164
|
-
- each package is a `@module`;
|
|
165
|
-
- Classes and Interfaces are categorized into `@category` and `@subcategory`;
|
|
166
|
-
- All other objects are categorized by `@namespace` and `@memberOf`;
|
|
167
|
-
- Enums and const are declared as `@const` and both must describe their properties as `@property` (when constants are objects);
|
|
168
|
-
- Interfaces must declare their methods `@method`;
|
|
169
|
-
|
|
170
|
-
There are 3 steps the generating the documentation (automated in CI):
|
|
171
|
-
- `npm run drawings` - generates png files from each drawing in the `workdocs/drawings` folder and moves them to the `workdocs/resources` folder (requires Docker);
|
|
172
|
-
- `npm run uml` - generates png files from each PlantUML diagram in the `workdocs/uml` folder and moves them to the `workdocs/resources` folder (requires Docker);
|
|
173
|
-
- `npm run docs` - this has several stages, defined under the `gulp docs` (gulpfile.js):
|
|
174
|
-
- compiles the Readme file via md compile:
|
|
175
|
-
- enables keeping separate files for sections that are then joined into a single file;
|
|
176
|
-
- Allows keeping specific files in the jsdocs tutorial folder so they show up on their own menu;
|
|
177
|
-
- compiles the documentation from the source code using jsdocs:
|
|
178
|
-
- uses the better docs template with the category and component plugins
|
|
179
|
-
- uses the mermaid jsdoc plugin to embue uml diagrams in the docs
|
|
180
|
-
- includes a nav link to the test coverage results;
|
|
181
|
-
- copies the jsdoc and mds to `/docs`;
|
|
182
|
-
- copies the `./workdocs/{drawings, uml, assets, resources}` to `./docs`;
|
|
183
|
-
|
|
184
|
-
The produced `docs` folder contains the resulting documentation;
|
|
185
|
-
### Related
|
|
186
63
|
|
|
187
|
-
[](https://github.com/decaf-ts/ts-workspace)
|
|
188
|
-
### Social
|
|
189
64
|
|
|
190
|
-
|
|
191
|
-
### Scripts
|
|
192
|
-
|
|
193
|
-
The following npm scripts are available for development:
|
|
194
|
-
|
|
195
|
-
- `preinstall` - will run only on the first install to trigger the dep update. will self delete;
|
|
196
|
-
- `do-install` - sets a `TOKEN` environment variable to the contents of `.token` and runs npm install (useful when you
|
|
197
|
-
have private dependencies);
|
|
198
|
-
- `flash-forward` - updates all dependencies. Take care, This may not be desirable is some cases;
|
|
199
|
-
- `reset` - updates all dependencies. Take care, This may not be desirable is some cases;
|
|
200
|
-
- `build` - builds the code (via gulp `gulpfile.js`) in development mode (generates `lib` and `dist` folder);
|
|
201
|
-
- `build:prod` - builds the code (via gulp `gulpfile.js`) in production mode (generates `lib` and `dist` folder);
|
|
202
|
-
- `test` - runs unit tests;
|
|
203
|
-
- `test:integration` - runs it tests;
|
|
204
|
-
- `test:all` - runs all tests;
|
|
205
|
-
- `lint` - runs es lint on the code folder;
|
|
206
|
-
- `lint-fix` - tries to auto-fix the code folder;
|
|
207
|
-
- `prepare-release` - defines the commands to run prior to a new tag (defaults to linting, building production code,
|
|
208
|
-
running tests and documentation generation);
|
|
209
|
-
- `release` - triggers a new tag being pushed to master (via `./bin/tag_release.sh`);
|
|
210
|
-
- `clean-publish` - cleans the package.json for publishing;
|
|
211
|
-
- `coverage` - runs all test, calculates coverage and generates badges for readme;
|
|
212
|
-
- `drawings` - compiles all DrawIO `*.drawio` files in the `workdocs/drawings` folder to png and moves them to
|
|
213
|
-
the `workdocs/resources` folder;
|
|
214
|
-
- `uml` - compiles all PlantUML `*.puml` files in the `workdocs/uml` folder to png and moves them to
|
|
215
|
-
the `workdocs/resources` folder;
|
|
216
|
-
- `docs` - compiles all the coverage, drawings, uml, jsdocs and md docs into a readable web page under `./docs`;
|
|
217
|
-
|
|
218
|
-
### Repository Structure
|
|
219
|
-
|
|
220
|
-
```
|
|
221
|
-
ts-workspace
|
|
222
|
-
│
|
|
223
|
-
│ .gitignore <-- Defines files ignored to git
|
|
224
|
-
│ .npmignore <-- Defines files ignored by npm
|
|
225
|
-
│ .nmprc <-- Defines the Npm registry for this package
|
|
226
|
-
│ .eslintrc.cjs <-- linting for the project
|
|
227
|
-
│ .prettier.config.cjs <-- Code style for the project
|
|
228
|
-
│ .gitlab-ci.yml <-- Gillab CI/CD file
|
|
229
|
-
│ gulpfile.js <-- Gulp build scripts. used for building na other features (eg docs)
|
|
230
|
-
│ jest.config.ts <-- Tests Configuration file
|
|
231
|
-
│ mdCompile.json <-- md Documentation generation configuration file
|
|
232
|
-
│ jsdocs.json <-- jsdoc Documentation generation configuration file
|
|
233
|
-
│ Dockerfile <-- minimal example of a node service Dockerfile
|
|
234
|
-
│ LICENCE.md <-- Licence disclamer
|
|
235
|
-
│ package.json
|
|
236
|
-
│ package-lock.json
|
|
237
|
-
│ README.md <-- Readme File dynamically compiled from 'workdocs' via the 'docs' npm script
|
|
238
|
-
│ tsconfig.json <-- Typescript config file. Is overriden in 'gulpfile.js'
|
|
239
|
-
│
|
|
240
|
-
└───bin
|
|
241
|
-
│ │ tag_release.sh <-- Script to help with releases
|
|
242
|
-
│
|
|
243
|
-
└───docs
|
|
244
|
-
│ │ ... <-- Dinamically generated folder, containing the compiled documentation for this repository. generated via the 'docs' npm script
|
|
245
|
-
│
|
|
246
|
-
└───src
|
|
247
|
-
│ │ ... <-- Source code for this repository
|
|
248
|
-
│
|
|
249
|
-
└───tests
|
|
250
|
-
│ │───unit <-- Unit tests
|
|
251
|
-
│ └───integration <-- Integration tests
|
|
252
|
-
│
|
|
253
|
-
└───workdocs <-- Folder with all pre-compiled documentation
|
|
254
|
-
│ │───assets <-- Documentation asset folder
|
|
255
|
-
│ │───badges <-- Auto generated coverage badges folder
|
|
256
|
-
│ │───coverage <-- Auto generated coverage results
|
|
257
|
-
│ │───drawings <-- DrawIO folder. Drawings (*.drawio) here will be processed to generate documentation (requires docker)
|
|
258
|
-
│ │───uml <-- PlantUML folder. Diagrams (*.puml) here will be processed to generate documentation (requires docker)
|
|
259
|
-
│ │───tutorials <-- Tutorial folder
|
|
260
|
-
│ │ ... <-- Categorized *.md files that are merged to generate the final readme (via md compile)
|
|
261
|
-
│ │ Readme.md <-- Entry point to the README.md
|
|
262
|
-
│
|
|
263
|
-
└───dist
|
|
264
|
-
│ │ ... <-- Dinamically generated folder containing the bundles for distribution
|
|
265
|
-
│
|
|
266
|
-
└───lib
|
|
267
|
-
| ... <-- Dinamically generated folder containing the compiled code
|
|
268
|
-
```
|
|
65
|
+
#### Languages
|
|
269
66
|
|
|
270
67
|
|
|
271
68
|
|
|
@@ -284,14 +81,12 @@ I am grateful for any contributions made to this project. Please read [this](./w
|
|
|
284
81
|
|
|
285
82
|
The first and easiest way you can support it is by [Contributing](./workdocs/98-Contributing.md). Even just finding a typo in the documentation is important.
|
|
286
83
|
|
|
287
|
-
Financial support is always welcome and helps keep
|
|
84
|
+
Financial support is always welcome and helps keep both me and the project alive and healthy.
|
|
288
85
|
|
|
289
86
|
So if you can, if this project in any way. either by learning something or simply by helping you save precious time, please consider donating.
|
|
290
87
|
|
|
291
88
|
## License
|
|
292
89
|
|
|
293
|
-
This project is released under the [MIT License](LICENSE.md).
|
|
294
|
-
|
|
295
|
-
#### Disclaimer:
|
|
90
|
+
This project is released under the [MIT License](./LICENSE.md).
|
|
296
91
|
|
|
297
|
-
|
|
92
|
+
By developers, for developers...
|
package/dist/cli.cjs
ADDED
|
@@ -0,0 +1,245 @@
|
|
|
1
|
+
(function (global, factory) {
|
|
2
|
+
typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('commander'), require('fs'), require('path')) :
|
|
3
|
+
typeof define === 'function' && define.amd ? define(['exports', 'commander', 'fs', 'path'], factory) :
|
|
4
|
+
(global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.cli = {}, global.commander, global.fs, global.path));
|
|
5
|
+
})(this, (function (exports, commander, fs, path) { 'use strict';
|
|
6
|
+
|
|
7
|
+
/**
|
|
8
|
+
* @description The name for decaf cli modules where each library must export
|
|
9
|
+
* a single {@link CliModule}
|
|
10
|
+
*
|
|
11
|
+
* @constant
|
|
12
|
+
* @memberOf module:CLI.cli
|
|
13
|
+
*/
|
|
14
|
+
const CLI_FILE_NAME = "cli-module";
|
|
15
|
+
|
|
16
|
+
/**
|
|
17
|
+
* @description util class to retrieve versions and other information
|
|
18
|
+
*
|
|
19
|
+
* @class CLIUtils
|
|
20
|
+
* @static
|
|
21
|
+
*/
|
|
22
|
+
class CLIUtils {
|
|
23
|
+
/**
|
|
24
|
+
* @description Dynamically imports a cjs file into a decaf module
|
|
25
|
+
* @param {string} path
|
|
26
|
+
* @static
|
|
27
|
+
*/
|
|
28
|
+
static async loadFromFile(path) {
|
|
29
|
+
try {
|
|
30
|
+
return CLIUtils.normalizeImport(import(path));
|
|
31
|
+
}
|
|
32
|
+
catch (e) {
|
|
33
|
+
throw new Error(`Failed to load from ${path}: ${e instanceof Error ? e.message : e}`);
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* @description allows safe dynamic imports
|
|
38
|
+
* @summary property imports JS files regardless of esm status
|
|
39
|
+
*
|
|
40
|
+
* @typeParam T
|
|
41
|
+
* @param {Promise} importPromise
|
|
42
|
+
* @private
|
|
43
|
+
*/
|
|
44
|
+
static async normalizeImport(importPromise) {
|
|
45
|
+
// CommonJS's `module.exports` is wrapped as `default` in ESModule.
|
|
46
|
+
return importPromise.then((m) => (m.default || m));
|
|
47
|
+
}
|
|
48
|
+
/**
|
|
49
|
+
* @description initializes the Cli object
|
|
50
|
+
*
|
|
51
|
+
* @param {Command} command
|
|
52
|
+
* @param {string} [basePath] defaults to the current working directory
|
|
53
|
+
*/
|
|
54
|
+
static initialize(command, basePath) {
|
|
55
|
+
const name = CLIUtils.packageName(basePath);
|
|
56
|
+
command
|
|
57
|
+
.name(name)
|
|
58
|
+
.description(`Runs ${name} related commands`)
|
|
59
|
+
.version(CLIUtils.packageVersion(basePath));
|
|
60
|
+
}
|
|
61
|
+
/**
|
|
62
|
+
* @description retrieves and parses the package.json file
|
|
63
|
+
*
|
|
64
|
+
* @param {string} basePath
|
|
65
|
+
* @private
|
|
66
|
+
*/
|
|
67
|
+
static getPackage(basePath) {
|
|
68
|
+
try {
|
|
69
|
+
return JSON.parse(fs.readFileSync(path.join(basePath, "package.json"), "utf8"));
|
|
70
|
+
}
|
|
71
|
+
catch (e) {
|
|
72
|
+
throw new Error(`Unable to read version from ${basePath}: ${e}`);
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
/**
|
|
76
|
+
* @description returns the package version
|
|
77
|
+
* @param {string} [basePath] defaults to current working dir
|
|
78
|
+
*/
|
|
79
|
+
static packageVersion(basePath) {
|
|
80
|
+
return CLIUtils.getPackage(basePath)["version"];
|
|
81
|
+
}
|
|
82
|
+
/**
|
|
83
|
+
* @description returns the package name
|
|
84
|
+
* @param {string} [basePath] defaults to current working dir
|
|
85
|
+
*/
|
|
86
|
+
static packageName(basePath) {
|
|
87
|
+
return CLIUtils.getPackage(basePath)["name"].split("/")[1];
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
/**
|
|
92
|
+
* @summary Util class to handle CLI functionality from all Decaf modules
|
|
93
|
+
* @description CLI handler class
|
|
94
|
+
*
|
|
95
|
+
* @param {string} [basepath] the base path to look for modules in. defaults to `./`
|
|
96
|
+
* @param {string} [crawlLevels] folders to crawl to find modules from the basePath. defaults to 4
|
|
97
|
+
*
|
|
98
|
+
* @class CliWrapper
|
|
99
|
+
*/
|
|
100
|
+
class CliWrapper {
|
|
101
|
+
constructor(basePath = "./", crawlLevels = 4) {
|
|
102
|
+
this.basePath = basePath;
|
|
103
|
+
this.crawlLevels = crawlLevels;
|
|
104
|
+
this.modules = {};
|
|
105
|
+
}
|
|
106
|
+
/**
|
|
107
|
+
* @description Retrieves and initializes the {@link Command} object
|
|
108
|
+
* @private
|
|
109
|
+
*/
|
|
110
|
+
get command() {
|
|
111
|
+
if (!this._command) {
|
|
112
|
+
this._command = new commander.Command();
|
|
113
|
+
CLIUtils.initialize(this._command, this.basePath);
|
|
114
|
+
}
|
|
115
|
+
return this._command;
|
|
116
|
+
}
|
|
117
|
+
/**
|
|
118
|
+
* @description loads and registers module from a file
|
|
119
|
+
*
|
|
120
|
+
* @param {string} filePath path to look for modules
|
|
121
|
+
* @param {string} rootPath repo root to find the package.json
|
|
122
|
+
* @return {string} the module name
|
|
123
|
+
*
|
|
124
|
+
* @private
|
|
125
|
+
*/
|
|
126
|
+
async load(filePath, rootPath) {
|
|
127
|
+
let name;
|
|
128
|
+
try {
|
|
129
|
+
const module = await CLIUtils.loadFromFile(filePath);
|
|
130
|
+
name = module.name;
|
|
131
|
+
const cmd = new commander.Command();
|
|
132
|
+
CLIUtils.initialize(cmd, path.dirname(rootPath));
|
|
133
|
+
let m = module();
|
|
134
|
+
if (m instanceof Promise)
|
|
135
|
+
m = await m;
|
|
136
|
+
this.modules[name] = m;
|
|
137
|
+
}
|
|
138
|
+
catch (e) {
|
|
139
|
+
throw new Error(`failed to load module ${name || "unnamed"} under ${filePath}: ${e instanceof Error ? e.message : e}`);
|
|
140
|
+
}
|
|
141
|
+
return name;
|
|
142
|
+
}
|
|
143
|
+
/**
|
|
144
|
+
* @description finds all the cli modules in the basePath via {@link CliWrapper.crawl}
|
|
145
|
+
* and loads them
|
|
146
|
+
* @private
|
|
147
|
+
*/
|
|
148
|
+
async boot() {
|
|
149
|
+
const basePath = path.join(process.cwd(), this.basePath);
|
|
150
|
+
const modules = this.crawl(basePath, this.crawlLevels);
|
|
151
|
+
for (const module of modules) {
|
|
152
|
+
if (module.includes("@decaf-ts/cli")) {
|
|
153
|
+
continue;
|
|
154
|
+
}
|
|
155
|
+
let name;
|
|
156
|
+
try {
|
|
157
|
+
name = await this.load(module, process.cwd());
|
|
158
|
+
}
|
|
159
|
+
catch (e) {
|
|
160
|
+
console.error(e);
|
|
161
|
+
continue;
|
|
162
|
+
}
|
|
163
|
+
if (!this.command.commands.find((c) => c["_name"] === name))
|
|
164
|
+
try {
|
|
165
|
+
this.command.command(name).addCommand(this.modules[name]);
|
|
166
|
+
}
|
|
167
|
+
catch (e) {
|
|
168
|
+
console.error(e);
|
|
169
|
+
}
|
|
170
|
+
}
|
|
171
|
+
console.log(`loaded modules:\n${Object.keys(this.modules)
|
|
172
|
+
.map((k) => `- ${k}`)
|
|
173
|
+
.join("\n")}`);
|
|
174
|
+
}
|
|
175
|
+
/**
|
|
176
|
+
* @description crawls the basePath up for 'levels' folders to find a module,eg a {@link CLI_FILE_NAME} named file
|
|
177
|
+
* @param {string} basePath the relative base batch to start searching in
|
|
178
|
+
* @param {number} [levels] the max number of levels to crawl. defaults to 2
|
|
179
|
+
* @private
|
|
180
|
+
*/
|
|
181
|
+
crawl(basePath, levels = 2) {
|
|
182
|
+
if (levels <= 0)
|
|
183
|
+
return [];
|
|
184
|
+
return fs.readdirSync(basePath).reduce((accum, file) => {
|
|
185
|
+
file = path.join(basePath, file);
|
|
186
|
+
if (fs.statSync(file).isDirectory()) {
|
|
187
|
+
accum.push(...this.crawl(file, levels - 1));
|
|
188
|
+
}
|
|
189
|
+
else if (file.match(new RegExp(`${CLI_FILE_NAME}.[cm]?js$`, "gm"))) {
|
|
190
|
+
accum.push(file);
|
|
191
|
+
}
|
|
192
|
+
return accum;
|
|
193
|
+
}, []);
|
|
194
|
+
}
|
|
195
|
+
/**
|
|
196
|
+
* @description runs the given command
|
|
197
|
+
*
|
|
198
|
+
* @param {string[]} [args] args to run. defaults to process.argv
|
|
199
|
+
*/
|
|
200
|
+
async run(args = process.argv) {
|
|
201
|
+
await this.boot();
|
|
202
|
+
return this.command.parseAsync(args);
|
|
203
|
+
}
|
|
204
|
+
}
|
|
205
|
+
|
|
206
|
+
/**
|
|
207
|
+
* @description Decaf-ts' CLI module
|
|
208
|
+
* @summary This file will crawl the current working directory for files called {@link CLI_FILE_NAME}
|
|
209
|
+
* within the @decaf-ts namespace and load then as subcommands
|
|
210
|
+
*
|
|
211
|
+
* @example
|
|
212
|
+
* run module command - $ npx decaf <module name> <module command> ...<module command options>
|
|
213
|
+
* get module help - $ npx decaf help <module name>;
|
|
214
|
+
* list imported modules - $ npx decaf list;
|
|
215
|
+
* get cli help - $ npx decaf help;
|
|
216
|
+
*
|
|
217
|
+
* @module CLI
|
|
218
|
+
*/
|
|
219
|
+
/**
|
|
220
|
+
* @description Decaf-ts' CLI namespace
|
|
221
|
+
* @summary This file will crawl the current working directory for files called {@link CLI_FILE_NAME}
|
|
222
|
+
* within the @decaf-ts namespace and load then as subcommands
|
|
223
|
+
*
|
|
224
|
+
* @example
|
|
225
|
+
* run module command - $ npx decaf <module name> <module command> ...<module command options>
|
|
226
|
+
* get module help - $ npx decaf help <module name>;
|
|
227
|
+
* list imported modules - $ npx decaf list;
|
|
228
|
+
* get cli help - $ npx decaf help;
|
|
229
|
+
*
|
|
230
|
+
* @namespace cli
|
|
231
|
+
* @memberOf module:CLI
|
|
232
|
+
*/
|
|
233
|
+
/**
|
|
234
|
+
* @summary stores the current package version
|
|
235
|
+
* @description this is how you should document a constant
|
|
236
|
+
* @const VERSION
|
|
237
|
+
* @memberOf module:CLI
|
|
238
|
+
*/
|
|
239
|
+
const VERSION = "0.3.1";
|
|
240
|
+
|
|
241
|
+
exports.CliWrapper = CliWrapper;
|
|
242
|
+
exports.VERSION = VERSION;
|
|
243
|
+
|
|
244
|
+
}));
|
|
245
|
+
//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpLmNqcyIsInNvdXJjZXMiOlsiLi4vc3JjL2NvbnN0YW50cy50cyIsIi4uL3NyYy91dGlscy50cyIsIi4uL3NyYy9DbGlXcmFwcGVyLnRzIiwiLi4vc3JjL2luZGV4LnRzIl0sInNvdXJjZXNDb250ZW50IjpbIi8vIGVzbGludC1kaXNhYmxlLW5leHQtbGluZSBAdHlwZXNjcmlwdC1lc2xpbnQvbm8tdW51c2VkLXZhcnNcbmltcG9ydCB7IENsaU1vZHVsZSB9IGZyb20gXCIuL3R5cGVzXCI7XG5cbi8qKlxuICogQGRlc2NyaXB0aW9uIFRoZSBuYW1lIGZvciBkZWNhZiBjbGkgbW9kdWxlcyB3aGVyZSBlYWNoIGxpYnJhcnkgbXVzdCBleHBvcnRcbiAqIGEgc2luZ2xlIHtAbGluayBDbGlNb2R1bGV9XG4gKlxuICogQGNvbnN0YW50XG4gKiBAbWVtYmVyT2YgbW9kdWxlOkNMSS5jbGlcbiAqL1xuZXhwb3J0IGNvbnN0IENMSV9GSUxFX05BTUUgPSBcImNsaS1tb2R1bGVcIjtcbiIsImltcG9ydCBwYXRoIGZyb20gXCJwYXRoXCI7XG5pbXBvcnQgZnMgZnJvbSBcImZzXCI7XG5pbXBvcnQgeyBDb21tYW5kIH0gZnJvbSBcImNvbW1hbmRlclwiO1xuaW1wb3J0IHsgQ2xpTW9kdWxlIH0gZnJvbSBcIi4vdHlwZXNcIjtcblxuLyoqXG4gKiBAZGVzY3JpcHRpb24gdXRpbCBjbGFzcyB0byByZXRyaWV2ZSB2ZXJzaW9ucyBhbmQgb3RoZXIgaW5mb3JtYXRpb25cbiAqXG4gKiBAY2xhc3MgQ0xJVXRpbHNcbiAqIEBzdGF0aWNcbiAqL1xuZXhwb3J0IGNsYXNzIENMSVV0aWxzIHtcbiAgLyoqXG4gICAqIEBkZXNjcmlwdGlvbiBEeW5hbWljYWxseSBpbXBvcnRzIGEgY2pzIGZpbGUgaW50byBhIGRlY2FmIG1vZHVsZVxuICAgKiBAcGFyYW0ge3N0cmluZ30gcGF0aFxuICAgKiBAc3RhdGljXG4gICAqL1xuICBzdGF0aWMgYXN5bmMgbG9hZEZyb21GaWxlKHBhdGg6IHN0cmluZyk6IFByb21pc2U8Q2xpTW9kdWxlPiB7XG4gICAgdHJ5IHtcbiAgICAgIHJldHVybiBDTElVdGlscy5ub3JtYWxpemVJbXBvcnQoaW1wb3J0KHBhdGgpKTtcbiAgICB9IGNhdGNoIChlOiB1bmtub3duKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoXG4gICAgICAgIGBGYWlsZWQgdG8gbG9hZCBmcm9tICR7cGF0aH06ICR7ZSBpbnN0YW5jZW9mIEVycm9yID8gZS5tZXNzYWdlIDogZX1gXG4gICAgICApO1xuICAgIH1cbiAgfVxuXG4gIC8qKlxuICAgKiBAZGVzY3JpcHRpb24gYWxsb3dzIHNhZmUgZHluYW1pYyBpbXBvcnRzXG4gICAqIEBzdW1tYXJ5IHByb3BlcnR5IGltcG9ydHMgSlMgZmlsZXMgcmVnYXJkbGVzcyBvZiBlc20gc3RhdHVzXG4gICAqXG4gICAqIEB0eXBlUGFyYW0gVFxuICAgKiBAcGFyYW0ge1Byb21pc2V9IGltcG9ydFByb21pc2VcbiAgICogQHByaXZhdGVcbiAgICovXG4gIHN0YXRpYyBhc3luYyBub3JtYWxpemVJbXBvcnQ8VD4oaW1wb3J0UHJvbWlzZTogUHJvbWlzZTxUPik6IFByb21pc2U8VD4ge1xuICAgIC8vIENvbW1vbkpTJ3MgYG1vZHVsZS5leHBvcnRzYCBpcyB3cmFwcGVkIGFzIGBkZWZhdWx0YCBpbiBFU01vZHVsZS5cbiAgICByZXR1cm4gaW1wb3J0UHJvbWlzZS50aGVuKFxuICAgICAgKG06IHVua25vd24pID0+ICgobSBhcyB7IGRlZmF1bHQ6IFQgfSkuZGVmYXVsdCB8fCBtKSBhcyBUXG4gICAgKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBAZGVzY3JpcHRpb24gaW5pdGlhbGl6ZXMgdGhlIENsaSBvYmplY3RcbiAgICpcbiAgICogQHBhcmFtIHtDb21tYW5kfSBjb21tYW5kXG4gICAqIEBwYXJhbSB7c3RyaW5nfSBbYmFzZVBhdGhdIGRlZmF1bHRzIHRvIHRoZSBjdXJyZW50IHdvcmtpbmcgZGlyZWN0b3J5XG4gICAqL1xuICBzdGF0aWMgaW5pdGlhbGl6ZShjb21tYW5kOiBDb21tYW5kLCBiYXNlUGF0aDogc3RyaW5nKSB7XG4gICAgY29uc3QgbmFtZSA9IENMSVV0aWxzLnBhY2thZ2VOYW1lKGJhc2VQYXRoKTtcbiAgICBjb21tYW5kXG4gICAgICAubmFtZShuYW1lKVxuICAgICAgLmRlc2NyaXB0aW9uKGBSdW5zICR7bmFtZX0gcmVsYXRlZCBjb21tYW5kc2ApXG4gICAgICAudmVyc2lvbihDTElVdGlscy5wYWNrYWdlVmVyc2lvbihiYXNlUGF0aCkpO1xuICB9XG5cbiAgLyoqXG4gICAqIEBkZXNjcmlwdGlvbiByZXRyaWV2ZXMgYW5kIHBhcnNlcyB0aGUgcGFja2FnZS5qc29uIGZpbGVcbiAgICpcbiAgICogQHBhcmFtIHtzdHJpbmd9IGJhc2VQYXRoXG4gICAqIEBwcml2YXRlXG4gICAqL1xuICBwcml2YXRlIHN0YXRpYyBnZXRQYWNrYWdlKGJhc2VQYXRoOiBzdHJpbmcpOiBSZWNvcmQ8c3RyaW5nLCB1bmtub3duPiB7XG4gICAgdHJ5IHtcbiAgICAgIHJldHVybiBKU09OLnBhcnNlKFxuICAgICAgICBmcy5yZWFkRmlsZVN5bmMocGF0aC5qb2luKGJhc2VQYXRoLCBcInBhY2thZ2UuanNvblwiKSwgXCJ1dGY4XCIpXG4gICAgICApO1xuICAgIH0gY2F0Y2ggKGU6IHVua25vd24pIHtcbiAgICAgIHRocm93IG5ldyBFcnJvcihgVW5hYmxlIHRvIHJlYWQgdmVyc2lvbiBmcm9tICR7YmFzZVBhdGh9OiAke2V9YCk7XG4gICAgfVxuICB9XG5cbiAgLyoqXG4gICAqIEBkZXNjcmlwdGlvbiByZXR1cm5zIHRoZSBwYWNrYWdlIHZlcnNpb25cbiAgICogQHBhcmFtIHtzdHJpbmd9IFtiYXNlUGF0aF0gZGVmYXVsdHMgdG8gY3VycmVudCB3b3JraW5nIGRpclxuICAgKi9cbiAgc3RhdGljIHBhY2thZ2VWZXJzaW9uKGJhc2VQYXRoOiBzdHJpbmcpOiBzdHJpbmcge1xuICAgIHJldHVybiBDTElVdGlscy5nZXRQYWNrYWdlKGJhc2VQYXRoKVtcInZlcnNpb25cIl0gYXMgc3RyaW5nO1xuICB9XG5cbiAgLyoqXG4gICAqIEBkZXNjcmlwdGlvbiByZXR1cm5zIHRoZSBwYWNrYWdlIG5hbWVcbiAgICogQHBhcmFtIHtzdHJpbmd9IFtiYXNlUGF0aF0gZGVmYXVsdHMgdG8gY3VycmVudCB3b3JraW5nIGRpclxuICAgKi9cbiAgc3RhdGljIHBhY2thZ2VOYW1lKGJhc2VQYXRoOiBzdHJpbmcpOiBzdHJpbmcge1xuICAgIHJldHVybiAoQ0xJVXRpbHMuZ2V0UGFja2FnZShiYXNlUGF0aClbXCJuYW1lXCJdIGFzIHN0cmluZykuc3BsaXQoXCIvXCIpWzFdO1xuICB9XG59XG4iLCJpbXBvcnQgeyBDb21tYW5kIH0gZnJvbSBcImNvbW1hbmRlclwiO1xuaW1wb3J0IGZzIGZyb20gXCJmc1wiO1xuaW1wb3J0IHBhdGggZnJvbSBcInBhdGhcIjtcbmltcG9ydCB7IENMSV9GSUxFX05BTUUgfSBmcm9tIFwiLi9jb25zdGFudHNcIjtcbmltcG9ydCB7IENMSVV0aWxzIH0gZnJvbSBcIi4vdXRpbHNcIjtcblxuLyoqXG4gKiBAc3VtbWFyeSBVdGlsIGNsYXNzIHRvIGhhbmRsZSBDTEkgZnVuY3Rpb25hbGl0eSBmcm9tIGFsbCBEZWNhZiBtb2R1bGVzXG4gKiBAZGVzY3JpcHRpb24gQ0xJIGhhbmRsZXIgY2xhc3NcbiAqXG4gKiBAcGFyYW0ge3N0cmluZ30gW2Jhc2VwYXRoXSB0aGUgYmFzZSBwYXRoIHRvIGxvb2sgZm9yIG1vZHVsZXMgaW4uIGRlZmF1bHRzIHRvIGAuL2BcbiAqIEBwYXJhbSB7c3RyaW5nfSBbY3Jhd2xMZXZlbHNdIGZvbGRlcnMgdG8gY3Jhd2wgdG8gZmluZCBtb2R1bGVzIGZyb20gdGhlIGJhc2VQYXRoLiBkZWZhdWx0cyB0byA0XG4gKlxuICogQGNsYXNzIENsaVdyYXBwZXJcbiAqL1xuZXhwb3J0IGNsYXNzIENsaVdyYXBwZXIge1xuICBwcml2YXRlIF9jb21tYW5kPzogQ29tbWFuZDtcbiAgcHJpdmF0ZSBtb2R1bGVzOiBSZWNvcmQ8c3RyaW5nLCBDb21tYW5kPiA9IHt9O1xuXG4gIGNvbnN0cnVjdG9yKFxuICAgIHByaXZhdGUgYmFzZVBhdGg6IHN0cmluZyA9IFwiLi9cIixcbiAgICBwcml2YXRlIGNyYXdsTGV2ZWxzID0gNFxuICApIHt9XG5cbiAgLyoqXG4gICAqIEBkZXNjcmlwdGlvbiBSZXRyaWV2ZXMgYW5kIGluaXRpYWxpemVzIHRoZSB7QGxpbmsgQ29tbWFuZH0gb2JqZWN0XG4gICAqIEBwcml2YXRlXG4gICAqL1xuICBwcml2YXRlIGdldCBjb21tYW5kKCkge1xuICAgIGlmICghdGhpcy5fY29tbWFuZCkge1xuICAgICAgdGhpcy5fY29tbWFuZCA9IG5ldyBDb21tYW5kKCk7XG4gICAgICBDTElVdGlscy5pbml0aWFsaXplKHRoaXMuX2NvbW1hbmQsIHRoaXMuYmFzZVBhdGgpO1xuICAgIH1cbiAgICByZXR1cm4gdGhpcy5fY29tbWFuZDtcbiAgfVxuXG4gIC8qKlxuICAgKiBAZGVzY3JpcHRpb24gbG9hZHMgYW5kIHJlZ2lzdGVycyBtb2R1bGUgZnJvbSBhIGZpbGVcbiAgICpcbiAgICogQHBhcmFtIHtzdHJpbmd9IGZpbGVQYXRoIHBhdGggdG8gbG9vayBmb3IgbW9kdWxlc1xuICAgKiBAcGFyYW0ge3N0cmluZ30gcm9vdFBhdGggcmVwbyByb290IHRvIGZpbmQgdGhlIHBhY2thZ2UuanNvblxuICAgKiBAcmV0dXJuIHtzdHJpbmd9IHRoZSBtb2R1bGUgbmFtZVxuICAgKlxuICAgKiBAcHJpdmF0ZVxuICAgKi9cbiAgcHJpdmF0ZSBhc3luYyBsb2FkKGZpbGVQYXRoOiBzdHJpbmcsIHJvb3RQYXRoOiBzdHJpbmcpOiBQcm9taXNlPHN0cmluZz4ge1xuICAgIGxldCBuYW1lO1xuICAgIHRyeSB7XG4gICAgICBjb25zdCBtb2R1bGUgPSBhd2FpdCBDTElVdGlscy5sb2FkRnJvbUZpbGUoZmlsZVBhdGgpO1xuICAgICAgbmFtZSA9IG1vZHVsZS5uYW1lO1xuICAgICAgY29uc3QgY21kID0gbmV3IENvbW1hbmQoKTtcbiAgICAgIENMSVV0aWxzLmluaXRpYWxpemUoY21kLCBwYXRoLmRpcm5hbWUocm9vdFBhdGgpKTtcbiAgICAgIGxldCBtID0gbW9kdWxlKCk7XG4gICAgICBpZiAobSBpbnN0YW5jZW9mIFByb21pc2UpIG0gPSBhd2FpdCBtO1xuICAgICAgdGhpcy5tb2R1bGVzW25hbWVdID0gbTtcbiAgICB9IGNhdGNoIChlOiB1bmtub3duKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoXG4gICAgICAgIGBmYWlsZWQgdG8gbG9hZCBtb2R1bGUgJHtuYW1lIHx8IFwidW5uYW1lZFwifSB1bmRlciAke2ZpbGVQYXRofTogJHtlIGluc3RhbmNlb2YgRXJyb3IgPyBlLm1lc3NhZ2UgOiBlfWBcbiAgICAgICk7XG4gICAgfVxuICAgIHJldHVybiBuYW1lO1xuICB9XG5cbiAgLyoqXG4gICAqIEBkZXNjcmlwdGlvbiBmaW5kcyBhbGwgdGhlIGNsaSBtb2R1bGVzIGluIHRoZSBiYXNlUGF0aCB2aWEge0BsaW5rIENsaVdyYXBwZXIuY3Jhd2x9XG4gICAqIGFuZCBsb2FkcyB0aGVtXG4gICAqIEBwcml2YXRlXG4gICAqL1xuICBwcml2YXRlIGFzeW5jIGJvb3QoKSB7XG4gICAgY29uc3QgYmFzZVBhdGggPSBwYXRoLmpvaW4ocHJvY2Vzcy5jd2QoKSwgdGhpcy5iYXNlUGF0aCk7XG4gICAgY29uc3QgbW9kdWxlcyA9IHRoaXMuY3Jhd2woYmFzZVBhdGgsIHRoaXMuY3Jhd2xMZXZlbHMpO1xuICAgIGZvciAoY29uc3QgbW9kdWxlIG9mIG1vZHVsZXMpIHtcbiAgICAgIGlmIChtb2R1bGUuaW5jbHVkZXMoXCJAZGVjYWYtdHMvY2xpXCIpKSB7XG4gICAgICAgIGNvbnRpbnVlO1xuICAgICAgfVxuICAgICAgbGV0IG5hbWU6IHN0cmluZztcbiAgICAgIHRyeSB7XG4gICAgICAgIG5hbWUgPSBhd2FpdCB0aGlzLmxvYWQobW9kdWxlLCBwcm9jZXNzLmN3ZCgpKTtcbiAgICAgIH0gY2F0Y2ggKGU6IHVua25vd24pIHtcbiAgICAgICAgY29uc29sZS5lcnJvcihlKTtcbiAgICAgICAgY29udGludWU7XG4gICAgICB9XG5cbiAgICAgIGlmIChcbiAgICAgICAgIXRoaXMuY29tbWFuZC5jb21tYW5kcy5maW5kKFxuICAgICAgICAgIChjKSA9PiAoYyBhcyB1bmtub3duIGFzIFJlY29yZDxzdHJpbmcsIHN0cmluZz4pW1wiX25hbWVcIl0gPT09IG5hbWVcbiAgICAgICAgKVxuICAgICAgKVxuICAgICAgICB0cnkge1xuICAgICAgICAgIHRoaXMuY29tbWFuZC5jb21tYW5kKG5hbWUpLmFkZENvbW1hbmQodGhpcy5tb2R1bGVzW25hbWVdKTtcbiAgICAgICAgfSBjYXRjaCAoZTogdW5rbm93bikge1xuICAgICAgICAgIGNvbnNvbGUuZXJyb3IoZSk7XG4gICAgICAgIH1cbiAgICB9XG4gICAgY29uc29sZS5sb2coXG4gICAgICBgbG9hZGVkIG1vZHVsZXM6XFxuJHtPYmplY3Qua2V5cyh0aGlzLm1vZHVsZXMpXG4gICAgICAgIC5tYXAoKGspID0+IGAtICR7a31gKVxuICAgICAgICAuam9pbihcIlxcblwiKX1gXG4gICAgKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBAZGVzY3JpcHRpb24gY3Jhd2xzIHRoZSBiYXNlUGF0aCB1cCBmb3IgJ2xldmVscycgZm9sZGVycyB0byBmaW5kIGEgbW9kdWxlLGVnIGEge0BsaW5rIENMSV9GSUxFX05BTUV9IG5hbWVkIGZpbGVcbiAgICogQHBhcmFtIHtzdHJpbmd9IGJhc2VQYXRoIHRoZSByZWxhdGl2ZSBiYXNlIGJhdGNoIHRvIHN0YXJ0IHNlYXJjaGluZyBpblxuICAgKiBAcGFyYW0ge251bWJlcn0gW2xldmVsc10gdGhlIG1heCBudW1iZXIgb2YgbGV2ZWxzIHRvIGNyYXdsLiBkZWZhdWx0cyB0byAyXG4gICAqIEBwcml2YXRlXG4gICAqL1xuICBwcml2YXRlIGNyYXdsKGJhc2VQYXRoOiBzdHJpbmcsIGxldmVsczogbnVtYmVyID0gMikge1xuICAgIGlmIChsZXZlbHMgPD0gMCkgcmV0dXJuIFtdO1xuICAgIHJldHVybiBmcy5yZWFkZGlyU3luYyhiYXNlUGF0aCkucmVkdWNlKChhY2N1bTogc3RyaW5nW10sIGZpbGUpID0+IHtcbiAgICAgIGZpbGUgPSBwYXRoLmpvaW4oYmFzZVBhdGgsIGZpbGUpO1xuICAgICAgaWYgKGZzLnN0YXRTeW5jKGZpbGUpLmlzRGlyZWN0b3J5KCkpIHtcbiAgICAgICAgYWNjdW0ucHVzaCguLi50aGlzLmNyYXdsKGZpbGUsIGxldmVscyAtIDEpKTtcbiAgICAgIH0gZWxzZSBpZiAoZmlsZS5tYXRjaChuZXcgUmVnRXhwKGAke0NMSV9GSUxFX05BTUV9LltjbV0/anMkYCwgXCJnbVwiKSkpIHtcbiAgICAgICAgYWNjdW0ucHVzaChmaWxlKTtcbiAgICAgIH1cbiAgICAgIHJldHVybiBhY2N1bTtcbiAgICB9LCBbXSk7XG4gIH1cblxuICAvKipcbiAgICogQGRlc2NyaXB0aW9uIHJ1bnMgdGhlIGdpdmVuIGNvbW1hbmRcbiAgICpcbiAgICogQHBhcmFtIHtzdHJpbmdbXX0gW2FyZ3NdIGFyZ3MgdG8gcnVuLiBkZWZhdWx0cyB0byBwcm9jZXNzLmFyZ3ZcbiAgICovXG4gIGFzeW5jIHJ1bihhcmdzOiBzdHJpbmdbXSA9IHByb2Nlc3MuYXJndikge1xuICAgIGF3YWl0IHRoaXMuYm9vdCgpO1xuICAgIHJldHVybiB0aGlzLmNvbW1hbmQucGFyc2VBc3luYyhhcmdzKTtcbiAgfVxufVxuIiwiZXhwb3J0ICogZnJvbSBcIi4vQ2xpV3JhcHBlclwiO1xuXG4vKipcbiAqIEBkZXNjcmlwdGlvbiBEZWNhZi10cycgQ0xJIG1vZHVsZVxuICogQHN1bW1hcnkgVGhpcyBmaWxlIHdpbGwgY3Jhd2wgdGhlIGN1cnJlbnQgd29ya2luZyBkaXJlY3RvcnkgZm9yIGZpbGVzIGNhbGxlZCB7QGxpbmsgQ0xJX0ZJTEVfTkFNRX1cbiAqIHdpdGhpbiB0aGUgQGRlY2FmLXRzIG5hbWVzcGFjZSBhbmQgbG9hZCB0aGVuIGFzIHN1YmNvbW1hbmRzXG4gKlxuICogQGV4YW1wbGVcbiAqIHJ1biBtb2R1bGUgY29tbWFuZCAgICAgLSAkIG5weCBkZWNhZiA8bW9kdWxlIG5hbWU+IDxtb2R1bGUgY29tbWFuZD4gLi4uPG1vZHVsZSBjb21tYW5kIG9wdGlvbnM+XG4gKiBnZXQgbW9kdWxlIGhlbHAgICAgICAgIC0gJCBucHggZGVjYWYgaGVscCA8bW9kdWxlIG5hbWU+O1xuICogbGlzdCBpbXBvcnRlZCBtb2R1bGVzICAtICQgbnB4IGRlY2FmIGxpc3Q7XG4gKiBnZXQgY2xpIGhlbHAgICAgICAgICAgIC0gJCBucHggZGVjYWYgaGVscDtcbiAqXG4gKiBAbW9kdWxlIENMSVxuICovXG5cbi8qKlxuICogQGRlc2NyaXB0aW9uIERlY2FmLXRzJyBDTEkgbmFtZXNwYWNlXG4gKiBAc3VtbWFyeSBUaGlzIGZpbGUgd2lsbCBjcmF3bCB0aGUgY3VycmVudCB3b3JraW5nIGRpcmVjdG9yeSBmb3IgZmlsZXMgY2FsbGVkIHtAbGluayBDTElfRklMRV9OQU1FfVxuICogd2l0aGluIHRoZSBAZGVjYWYtdHMgbmFtZXNwYWNlIGFuZCBsb2FkIHRoZW4gYXMgc3ViY29tbWFuZHNcbiAqXG4gKiBAZXhhbXBsZVxuICogcnVuIG1vZHVsZSBjb21tYW5kICAgICAtICQgbnB4IGRlY2FmIDxtb2R1bGUgbmFtZT4gPG1vZHVsZSBjb21tYW5kPiAuLi48bW9kdWxlIGNvbW1hbmQgb3B0aW9ucz5cbiAqIGdldCBtb2R1bGUgaGVscCAgICAgICAgLSAkIG5weCBkZWNhZiBoZWxwIDxtb2R1bGUgbmFtZT47XG4gKiBsaXN0IGltcG9ydGVkIG1vZHVsZXMgIC0gJCBucHggZGVjYWYgbGlzdDtcbiAqIGdldCBjbGkgaGVscCAgICAgICAgICAgLSAkIG5weCBkZWNhZiBoZWxwO1xuICpcbiAqIEBuYW1lc3BhY2UgY2xpXG4gKiBAbWVtYmVyT2YgbW9kdWxlOkNMSVxuICovXG5cbi8qKlxuICogQHN1bW1hcnkgc3RvcmVzIHRoZSBjdXJyZW50IHBhY2thZ2UgdmVyc2lvblxuICogQGRlc2NyaXB0aW9uIHRoaXMgaXMgaG93IHlvdSBzaG91bGQgZG9jdW1lbnQgYSBjb25zdGFudFxuICogQGNvbnN0IFZFUlNJT05cbiAqIEBtZW1iZXJPZiBtb2R1bGU6Q0xJXG4gKi9cbmV4cG9ydCBjb25zdCBWRVJTSU9OID0gXCIjI1ZFUlNJT04jI1wiO1xuIl0sIm5hbWVzIjpbIkNvbW1hbmQiXSwibWFwcGluZ3MiOiI7Ozs7OztJQUdBOzs7Ozs7SUFNRztJQUNJLE1BQU0sYUFBYSxHQUFHLFlBQVk7O0lDTHpDOzs7OztJQUtHO1VBQ1UsUUFBUSxDQUFBO0lBQ25COzs7O0lBSUc7SUFDSCxJQUFBLGFBQWEsWUFBWSxDQUFDLElBQVksRUFBQTtJQUNwQyxRQUFBLElBQUk7Z0JBQ0YsT0FBTyxRQUFRLENBQUMsZUFBZSxDQUFDLE9BQU8sSUFBSSxDQUFDLENBQUM7O1lBQzdDLE9BQU8sQ0FBVSxFQUFFO2dCQUNuQixNQUFNLElBQUksS0FBSyxDQUNiLENBQUEsb0JBQUEsRUFBdUIsSUFBSSxDQUFLLEVBQUEsRUFBQSxDQUFDLFlBQVksS0FBSyxHQUFHLENBQUMsQ0FBQyxPQUFPLEdBQUcsQ0FBQyxDQUFFLENBQUEsQ0FDckU7OztJQUlMOzs7Ozs7O0lBT0c7SUFDSCxJQUFBLGFBQWEsZUFBZSxDQUFJLGFBQXlCLEVBQUE7O0lBRXZELFFBQUEsT0FBTyxhQUFhLENBQUMsSUFBSSxDQUN2QixDQUFDLENBQVUsTUFBTyxDQUFvQixDQUFDLE9BQU8sSUFBSSxDQUFDLENBQU0sQ0FDMUQ7O0lBR0g7Ozs7O0lBS0c7SUFDSCxJQUFBLE9BQU8sVUFBVSxDQUFDLE9BQWdCLEVBQUUsUUFBZ0IsRUFBQTtZQUNsRCxNQUFNLElBQUksR0FBRyxRQUFRLENBQUMsV0FBVyxDQUFDLFFBQVEsQ0FBQztZQUMzQztpQkFDRyxJQUFJLENBQUMsSUFBSTtJQUNULGFBQUEsV0FBVyxDQUFDLENBQUEsS0FBQSxFQUFRLElBQUksQ0FBQSxpQkFBQSxDQUFtQjtpQkFDM0MsT0FBTyxDQUFDLFFBQVEsQ0FBQyxjQUFjLENBQUMsUUFBUSxDQUFDLENBQUM7O0lBRy9DOzs7OztJQUtHO1FBQ0ssT0FB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
|