mirror of
https://code.forgejo.org/actions/setup-node.git
synced 2025-05-19 21:04:45 +00:00
.
This commit is contained in:
parent
beb1329f9f
commit
2b95e76931
7736 changed files with 1874747 additions and 51184 deletions
23
node_modules/jest-docblock/LICENSE
generated
vendored
Normal file
23
node_modules/jest-docblock/LICENSE
generated
vendored
Normal file
|
@ -0,0 +1,23 @@
|
|||
MIT License
|
||||
|
||||
For Jest software
|
||||
|
||||
Copyright (c) 2014-present, Facebook, Inc.
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to deal
|
||||
in the Software without restriction, including without limitation the rights
|
||||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||
copies of the Software, and to permit persons to whom the Software is
|
||||
furnished to do so, subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in all
|
||||
copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||
SOFTWARE.
|
108
node_modules/jest-docblock/README.md
generated
vendored
Normal file
108
node_modules/jest-docblock/README.md
generated
vendored
Normal file
|
@ -0,0 +1,108 @@
|
|||
# jest-docblock
|
||||
|
||||
`jest-docblock` is a package that can extract and parse a specially-formatted comment called a "docblock" at the top of a file.
|
||||
|
||||
A docblock looks like this:
|
||||
|
||||
```js
|
||||
/**
|
||||
* Stuff goes here!
|
||||
*/
|
||||
```
|
||||
|
||||
Docblocks can contain pragmas, which are words prefixed by `@`:
|
||||
|
||||
```js
|
||||
/**
|
||||
* Pragma incoming!
|
||||
*
|
||||
* @flow
|
||||
*/
|
||||
```
|
||||
|
||||
Pragmas can also take arguments:
|
||||
|
||||
```js
|
||||
/**
|
||||
* Check this out:
|
||||
*
|
||||
* @myPragma it is so cool
|
||||
*/
|
||||
```
|
||||
|
||||
`jest-docblock` can:
|
||||
|
||||
- extract the docblock from some code as a string
|
||||
- parse a docblock string's pragmas into an object
|
||||
- print an object and some comments back to a string
|
||||
|
||||
## Installation
|
||||
|
||||
```sh
|
||||
# with yarn
|
||||
$ yarn add jest-docblock
|
||||
# with npm
|
||||
$ npm install jest-docblock
|
||||
```
|
||||
|
||||
## Usage
|
||||
|
||||
```js
|
||||
const code = `
|
||||
/**
|
||||
* Everything is awesome!
|
||||
*
|
||||
* @everything is:awesome
|
||||
* @flow
|
||||
*/
|
||||
|
||||
export const everything = Object.create(null);
|
||||
export default function isAwesome(something) {
|
||||
return something === everything;
|
||||
}
|
||||
`;
|
||||
|
||||
const {
|
||||
extract,
|
||||
strip,
|
||||
parse,
|
||||
parseWithComments,
|
||||
print,
|
||||
} = require('jest-docblock');
|
||||
|
||||
const docblock = extract(code);
|
||||
console.log(docblock); // "/**\n * Everything is awesome!\n * \n * @everything is:awesome\n * @flow\n */"
|
||||
|
||||
const stripped = strip(code);
|
||||
console.log(stripped); // "export const everything = Object.create(null);\n export default function isAwesome(something) {\n return something === everything;\n }"
|
||||
|
||||
const pragmas = parse(docblock);
|
||||
console.log(pragmas); // { everything: "is:awesome", flow: "" }
|
||||
|
||||
const parsed = parseWithComments(docblock);
|
||||
console.log(parsed); // { comments: "Everything is awesome!", pragmas: { everything: "is:awesome", flow: "" } }
|
||||
|
||||
console.log(print({pragmas, comments: 'hi!'})); // /**\n * hi!\n *\n * @everything is:awesome\n * @flow\n */;
|
||||
```
|
||||
|
||||
## API Documentation
|
||||
|
||||
### `extract(contents: string): string`
|
||||
|
||||
Extracts a docblock from some file contents. Returns the docblock contained in `contents`. If `contents` did not contain a docblock, it will return the empty string (`""`).
|
||||
|
||||
### `strip(contents: string): string`
|
||||
|
||||
Strips the top docblock from a file and return the result. If a file does not have a docblock at the top, then return the file unchanged.
|
||||
|
||||
### `parse(docblock: string): {[key: string]: string | string[] }`
|
||||
|
||||
Parses the pragmas in a docblock string into an object whose keys are the pragma tags and whose values are the arguments to those pragmas.
|
||||
|
||||
### `parseWithComments(docblock: string): { comments: string, pragmas: {[key: string]: string | string[]} }`
|
||||
|
||||
Similar to `parse` except this method also returns the comments from the docblock. Useful when used with `print()`.
|
||||
|
||||
### `print({ comments?: string, pragmas?: {[key: string]: string | string[]} }): string`
|
||||
|
||||
Prints an object of key-value pairs back into a docblock. If `comments` are provided, they will be positioned on the top of the docblock.
|
22
node_modules/jest-docblock/build/index.d.ts
generated
vendored
Normal file
22
node_modules/jest-docblock/build/index.d.ts
generated
vendored
Normal file
|
@ -0,0 +1,22 @@
|
|||
/**
|
||||
* Copyright (c) Facebook, Inc. and its affiliates. All Rights Reserved.
|
||||
*
|
||||
* This source code is licensed under the MIT license found in the
|
||||
* LICENSE file in the root directory of this source tree.
|
||||
*/
|
||||
declare type Pragmas = {
|
||||
[key: string]: string | Array<string>;
|
||||
};
|
||||
export declare function extract(contents: string): string;
|
||||
export declare function strip(contents: string): string;
|
||||
export declare function parse(docblock: string): Pragmas;
|
||||
export declare function parseWithComments(docblock: string): {
|
||||
comments: string;
|
||||
pragmas: Pragmas;
|
||||
};
|
||||
export declare function print({ comments, pragmas, }: {
|
||||
comments?: string;
|
||||
pragmas?: Pragmas;
|
||||
}): string;
|
||||
export {};
|
||||
//# sourceMappingURL=index.d.ts.map
|
1
node_modules/jest-docblock/build/index.d.ts.map
generated
vendored
Normal file
1
node_modules/jest-docblock/build/index.d.ts.map
generated
vendored
Normal file
|
@ -0,0 +1 @@
|
|||
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,aAAK,OAAO,GAAG;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAA;CAAC,CAAC;AAWvD,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED,wBAAgB,KAAK,CAAC,QAAQ,EAAE,MAAM,UAGrC;AAED,wBAAgB,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,GACf;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAC,CAuCtC;AAED,wBAAgB,KAAK,CAAC,EACpB,QAAa,EACb,OAAY,GACb,EAAE;IACD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GAAG,MAAM,CAsCT"}
|
149
node_modules/jest-docblock/build/index.js
generated
vendored
Normal file
149
node_modules/jest-docblock/build/index.js
generated
vendored
Normal file
|
@ -0,0 +1,149 @@
|
|||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, '__esModule', {
|
||||
value: true
|
||||
});
|
||||
exports.extract = extract;
|
||||
exports.strip = strip;
|
||||
exports.parse = parse;
|
||||
exports.parseWithComments = parseWithComments;
|
||||
exports.print = print;
|
||||
|
||||
function _os() {
|
||||
const data = require('os');
|
||||
|
||||
_os = function _os() {
|
||||
return data;
|
||||
};
|
||||
|
||||
return data;
|
||||
}
|
||||
|
||||
function _detectNewline() {
|
||||
const data = _interopRequireDefault(require('detect-newline'));
|
||||
|
||||
_detectNewline = function _detectNewline() {
|
||||
return data;
|
||||
};
|
||||
|
||||
return data;
|
||||
}
|
||||
|
||||
function _interopRequireDefault(obj) {
|
||||
return obj && obj.__esModule ? obj : {default: obj};
|
||||
}
|
||||
|
||||
/**
|
||||
* Copyright (c) Facebook, Inc. and its affiliates. All Rights Reserved.
|
||||
*
|
||||
* This source code is licensed under the MIT license found in the
|
||||
* LICENSE file in the root directory of this source tree.
|
||||
*/
|
||||
const commentEndRe = /\*\/$/;
|
||||
const commentStartRe = /^\/\*\*/;
|
||||
const docblockRe = /^\s*(\/\*\*?(.|\r?\n)*?\*\/)/;
|
||||
const lineCommentRe = /(^|\s+)\/\/([^\r\n]*)/g;
|
||||
const ltrimNewlineRe = /^(\r?\n)+/;
|
||||
const multilineRe = /(?:^|\r?\n) *(@[^\r\n]*?) *\r?\n *(?![^@\r\n]*\/\/[^]*)([^@\r\n\s][^@\r\n]+?) *\r?\n/g;
|
||||
const propertyRe = /(?:^|\r?\n) *@(\S+) *([^\r\n]*)/g;
|
||||
const stringStartRe = /(\r?\n|^) *\* ?/g;
|
||||
|
||||
function extract(contents) {
|
||||
const match = contents.match(docblockRe);
|
||||
return match ? match[0].trimLeft() : '';
|
||||
}
|
||||
|
||||
function strip(contents) {
|
||||
const match = contents.match(docblockRe);
|
||||
return match && match[0] ? contents.substring(match[0].length) : contents;
|
||||
}
|
||||
|
||||
function parse(docblock) {
|
||||
return parseWithComments(docblock).pragmas;
|
||||
}
|
||||
|
||||
function parseWithComments(docblock) {
|
||||
const line = (0, _detectNewline().default)(docblock) || _os().EOL;
|
||||
|
||||
docblock = docblock
|
||||
.replace(commentStartRe, '')
|
||||
.replace(commentEndRe, '')
|
||||
.replace(stringStartRe, '$1'); // Normalize multi-line directives
|
||||
|
||||
let prev = '';
|
||||
|
||||
while (prev !== docblock) {
|
||||
prev = docblock;
|
||||
docblock = docblock.replace(multilineRe, `${line}$1 $2${line}`);
|
||||
}
|
||||
|
||||
docblock = docblock.replace(ltrimNewlineRe, '').trimRight();
|
||||
const result = Object.create(null);
|
||||
const comments = docblock
|
||||
.replace(propertyRe, '')
|
||||
.replace(ltrimNewlineRe, '')
|
||||
.trimRight();
|
||||
let match;
|
||||
|
||||
while ((match = propertyRe.exec(docblock))) {
|
||||
// strip linecomments from pragmas
|
||||
const nextPragma = match[2].replace(lineCommentRe, '');
|
||||
|
||||
if (
|
||||
typeof result[match[1]] === 'string' ||
|
||||
Array.isArray(result[match[1]])
|
||||
) {
|
||||
result[match[1]] = [].concat(result[match[1]], nextPragma);
|
||||
} else {
|
||||
result[match[1]] = nextPragma;
|
||||
}
|
||||
}
|
||||
|
||||
return {
|
||||
comments,
|
||||
pragmas: result
|
||||
};
|
||||
}
|
||||
|
||||
function print({comments = '', pragmas = {}}) {
|
||||
const line = (0, _detectNewline().default)(comments) || _os().EOL;
|
||||
|
||||
const head = '/**';
|
||||
const start = ' *';
|
||||
const tail = ' */';
|
||||
const keys = Object.keys(pragmas);
|
||||
const printedObject = keys
|
||||
.map(key => printKeyValues(key, pragmas[key]))
|
||||
.reduce((arr, next) => arr.concat(next), [])
|
||||
.map(keyValue => start + ' ' + keyValue + line)
|
||||
.join('');
|
||||
|
||||
if (!comments) {
|
||||
if (keys.length === 0) {
|
||||
return '';
|
||||
}
|
||||
|
||||
if (keys.length === 1 && !Array.isArray(pragmas[keys[0]])) {
|
||||
const value = pragmas[keys[0]];
|
||||
return `${head} ${printKeyValues(keys[0], value)[0]}${tail}`;
|
||||
}
|
||||
}
|
||||
|
||||
const printedComments =
|
||||
comments
|
||||
.split(line)
|
||||
.map(textLine => `${start} ${textLine}`)
|
||||
.join(line) + line;
|
||||
return (
|
||||
head +
|
||||
line +
|
||||
(comments ? printedComments : '') +
|
||||
(comments && keys.length ? start + line : '') +
|
||||
printedObject +
|
||||
tail
|
||||
);
|
||||
}
|
||||
|
||||
function printKeyValues(key, valueOrArray) {
|
||||
return [].concat(valueOrArray).map(value => `@${key} ${value}`.trim());
|
||||
}
|
58
node_modules/jest-docblock/package.json
generated
vendored
Normal file
58
node_modules/jest-docblock/package.json
generated
vendored
Normal file
|
@ -0,0 +1,58 @@
|
|||
{
|
||||
"_args": [
|
||||
[
|
||||
"jest-docblock@24.3.0",
|
||||
"/Users/eric/repos/actions/setup-node"
|
||||
]
|
||||
],
|
||||
"_development": true,
|
||||
"_from": "jest-docblock@24.3.0",
|
||||
"_id": "jest-docblock@24.3.0",
|
||||
"_inBundle": false,
|
||||
"_integrity": "sha512-nlANmF9Yq1dufhFlKG9rasfQlrY7wINJbo3q01tu56Jv5eBU5jirylhF2O5ZBnLxzOVBGRDz/9NAwNyBtG4Nyg==",
|
||||
"_location": "/jest-docblock",
|
||||
"_phantomChildren": {},
|
||||
"_requested": {
|
||||
"type": "version",
|
||||
"registry": true,
|
||||
"raw": "jest-docblock@24.3.0",
|
||||
"name": "jest-docblock",
|
||||
"escapedName": "jest-docblock",
|
||||
"rawSpec": "24.3.0",
|
||||
"saveSpec": null,
|
||||
"fetchSpec": "24.3.0"
|
||||
},
|
||||
"_requiredBy": [
|
||||
"/jest-runner"
|
||||
],
|
||||
"_resolved": "https://registry.npmjs.org/jest-docblock/-/jest-docblock-24.3.0.tgz",
|
||||
"_spec": "24.3.0",
|
||||
"_where": "/Users/eric/repos/actions/setup-node",
|
||||
"bugs": {
|
||||
"url": "https://github.com/facebook/jest/issues"
|
||||
},
|
||||
"dependencies": {
|
||||
"detect-newline": "^2.1.0"
|
||||
},
|
||||
"description": "`jest-docblock` is a package that can extract and parse a specially-formatted comment called a \"docblock\" at the top of a file.",
|
||||
"devDependencies": {
|
||||
"@types/detect-newline": "^2.1.0"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">= 6"
|
||||
},
|
||||
"gitHead": "3a7a4f3a3f5489ac8e07dcddf76bb949c482ec87",
|
||||
"homepage": "https://github.com/facebook/jest#readme",
|
||||
"license": "MIT",
|
||||
"main": "build/index.js",
|
||||
"name": "jest-docblock",
|
||||
"publishConfig": {
|
||||
"access": "public"
|
||||
},
|
||||
"repository": {
|
||||
"type": "git",
|
||||
"url": "git+https://github.com/facebook/jest.git",
|
||||
"directory": "packages/jest-docblock"
|
||||
},
|
||||
"version": "24.3.0"
|
||||
}
|
7
node_modules/jest-docblock/tsconfig.json
generated
vendored
Normal file
7
node_modules/jest-docblock/tsconfig.json
generated
vendored
Normal file
|
@ -0,0 +1,7 @@
|
|||
{
|
||||
"extends": "../../tsconfig.json",
|
||||
"compilerOptions": {
|
||||
"rootDir": "src",
|
||||
"outDir": "build"
|
||||
}
|
||||
}
|
Loading…
Add table
Add a link
Reference in a new issue