+
+[](https://codecov.io/gh/sindresorhus/execa) @@ -9,123 +12,173 @@ This package improves [`child_process`](https://nodejs.org/api/child_process.html) methods with: -- Promise interface. +- [Promise interface](#execacommandcommand-options). +- [Scripts interface](#scripts-interface), like `zx`. +- Improved [Windows support](https://github.com/IndigoUnited/node-cross-spawn#why), including [shebang](https://en.wikipedia.org/wiki/Shebang_(Unix)) binaries. +- Executes [locally installed binaries](#preferlocal) without `npx`. +- [Cleans up](#cleanup) child processes when the parent process ends. +- [Graceful termination](#optionsforcekillaftertimeout). +- Get [interleaved output](#all) from `stdout` and `stderr` similar to what is printed on the terminal. - [Strips the final newline](#stripfinalnewline) from the output so you don't have to do `stdout.trim()`. -- Supports [shebang](https://en.wikipedia.org/wiki/Shebang_(Unix)) binaries cross-platform. -- [Improved Windows support.](https://github.com/IndigoUnited/node-cross-spawn#why) -- Higher max buffer. 100 MB instead of 200 KB. -- [Executes locally installed binaries by name.](#preferlocal) -- [Cleans up spawned processes when the parent process dies.](#cleanup) -- [Get interleaved output](#all) from `stdout` and `stderr` similar to what is printed on the terminal. [*(Async only)*](#execasyncfile-arguments-options) -- [Can specify file and arguments as a single string without a shell](#execacommandcommand-options) +- Convenience methods to pipe processes' [input](#input) and [output](#redirect-output-to-a-file). +- Can specify file and arguments [as a single string](#execacommandcommand-options) without a shell. +- [Verbose mode](#verbose-mode) for debugging. - More descriptive errors. +- Higher max buffer: 100 MB instead of 1 MB. ## Install -``` -$ npm install execa +```sh +npm install execa ``` ## Usage +### Promise interface + ```js -const execa = require('execa'); +import {execa} from 'execa'; -(async () => { - const {stdout} = await execa('echo', ['unicorns']); - console.log(stdout); - //=> 'unicorns' -})(); +const {stdout} = await execa('echo', ['unicorns']); +console.log(stdout); +//=> 'unicorns' ``` -### Pipe the child process stdout to the parent +### Scripts interface + +For more information about Execa scripts, please see [this page](docs/scripts.md). + +#### Basic ```js -const execa = require('execa'); +import {$} from 'execa'; -execa('echo', ['unicorns']).stdout.pipe(process.stdout); +const branch = await $`git branch --show-current`; +await $`dep deploy --branch=${branch}`; ``` -### Handling Errors +#### Multiple arguments ```js -const execa = require('execa'); - -(async () => { - // Catching an error - try { - await execa('unknown', ['command']); - } catch (error) { - console.log(error); - /* - { - message: 'Command failed with ENOENT: unknown command spawn unknown ENOENT', - errno: -2, - code: 'ENOENT', - syscall: 'spawn unknown', - path: 'unknown', - spawnargs: ['command'], - originalMessage: 'spawn unknown ENOENT', - shortMessage: 'Command failed with ENOENT: unknown command spawn unknown ENOENT', - command: 'unknown command', - escapedCommand: 'unknown command', - stdout: '', - stderr: '', - all: '', - failed: true, - timedOut: false, - isCanceled: false, - killed: false - } - */ - } +import {$} from 'execa'; -})(); +const args = ['unicorns', '&', 'rainbows!']; +const {stdout} = await $`echo ${args}`; +console.log(stdout); +//=> 'unicorns & rainbows!' ``` -### Cancelling a spawned process +#### With options + +```js +import {$} from 'execa'; + +await $({stdio: 'inherit'})`echo unicorns`; +//=> 'unicorns' +``` + +#### Shared options ```js -const execa = require('execa'); +import {$} from 'execa'; -(async () => { - const subprocess = execa('node'); +const $$ = $({stdio: 'inherit'}); - setTimeout(() => { - subprocess.cancel(); - }, 1000); +await $$`echo unicorns`; +//=> 'unicorns' - try { - await subprocess; - } catch (error) { - console.log(subprocess.killed); // true - console.log(error.isCanceled); // true - } -})() +await $$`echo rainbows`; +//=> 'rainbows' +``` + +#### Verbose mode + +```sh +> node file.js +unicorns +rainbows + +> NODE_DEBUG=execa node file.js +[16:50:03.305] echo unicorns +unicorns +[16:50:03.308] echo rainbows +rainbows +``` + +### Input/output + +#### Redirect output to a file + +```js +import {execa} from 'execa'; + +// Similar to `echo unicorns > stdout.txt` in Bash +await execa('echo', ['unicorns']).pipeStdout('stdout.txt'); + +// Similar to `echo unicorns 2> stdout.txt` in Bash +await execa('echo', ['unicorns']).pipeStderr('stderr.txt'); + +// Similar to `echo unicorns &> stdout.txt` in Bash +await execa('echo', ['unicorns'], {all: true}).pipeAll('all.txt'); +``` + +#### Redirect input from a file + +```js +import {execa} from 'execa'; + +// Similar to `cat < stdin.txt` in Bash +const {stdout} = await execa('cat', {inputFile: 'stdin.txt'}); +console.log(stdout); +//=> 'unicorns' +``` + +#### Save and pipe output from a child process + +```js +import {execa} from 'execa'; + +const {stdout} = await execa('echo', ['unicorns']).pipeStdout(process.stdout); +// Prints `unicorns` +console.log(stdout); +// Also returns 'unicorns' +``` + +#### Pipe multiple processes + +```js +import {execa} from 'execa'; + +// Similar to `echo unicorns | cat` in Bash +const {stdout} = await execa('echo', ['unicorns']).pipeStdout(execa('cat')); +console.log(stdout); +//=> 'unicorns' ``` -### Catching an error with the sync method +### Handling Errors ```js +import {execa} from 'execa'; + +// Catching an error try { - execa.sync('unknown', ['command']); + await execa('unknown', ['command']); } catch (error) { console.log(error); /* { - message: 'Command failed with ENOENT: unknown command spawnSync unknown ENOENT', + message: 'Command failed with ENOENT: unknown command spawn unknown ENOENT', errno: -2, code: 'ENOENT', - syscall: 'spawnSync unknown', + syscall: 'spawn unknown', path: 'unknown', spawnargs: ['command'], - originalMessage: 'spawnSync unknown ENOENT', - shortMessage: 'Command failed with ENOENT: unknown command spawnSync unknown ENOENT', + originalMessage: 'spawn unknown ENOENT', + shortMessage: 'Command failed with ENOENT: unknown command spawn unknown ENOENT', command: 'unknown command', escapedCommand: 'unknown command', stdout: '', stderr: '', - all: '', failed: true, timedOut: false, isCanceled: false, @@ -135,7 +188,7 @@ try { } ``` -### Kill a process +### Graceful termination Using SIGTERM, and after 2 seconds, kill it with SIGKILL. @@ -151,17 +204,84 @@ setTimeout(() => { ## API -### execa(file, arguments, options?) +### Methods + +#### execa(file, arguments?, options?) + +Executes a command using `file ...arguments`. `arguments` are specified as an array of strings. Returns a [`childProcess`](#childprocess). + +Arguments are [automatically escaped](#shell-syntax). They can contain any character, including spaces. + +This is the preferred method when executing single commands. + +#### execaNode(scriptPath, arguments?, options?) + +Executes a Node.js file using `node scriptPath ...arguments`. `arguments` are specified as an array of strings. Returns a [`childProcess`](#childprocess). + +Arguments are [automatically escaped](#shell-syntax). They can contain any character, including spaces. + +This is the preferred method when executing Node.js files. + +Like [`child_process#fork()`](https://nodejs.org/api/child_process.html#child_process_child_process_fork_modulepath_args_options): + - the current Node version and options are used. This can be overridden using the [`nodePath`](#nodepath-for-node-only) and [`nodeOptions`](#nodeoptions-for-node-only) options. + - the [`shell`](#shell) option cannot be used + - an extra channel [`ipc`](https://nodejs.org/api/child_process.html#child_process_options_stdio) is passed to [`stdio`](#stdio) + +#### $\`command\` + +Executes a command. The `command` string includes both the `file` and its `arguments`. Returns a [`childProcess`](#childprocess). + +Arguments are [automatically escaped](#shell-syntax). They can contain any character, but spaces must use `${}` like `` $`echo ${'has space'}` ``. + +This is the preferred method when executing multiple commands in a script file. + +The `command` string can inject any `${value}` with the following types: string, number, [`childProcess`](#childprocess) or an array of those types. For example: `` $`echo one ${'two'} ${3} ${['four', 'five']}` ``. For `${childProcess}`, the process's `stdout` is used. + +For more information, please see [this section](#scripts-interface) and [this page](docs/scripts.md). + +#### $(options) + +Returns a new instance of [`$`](#command) but with different default `options`. Consecutive calls are merged to previous ones. + +This can be used to either: + - Set options for a specific command: `` $(options)`command` `` + - Share options for multiple commands: `` const $$ = $(options); $$`command`; $$`otherCommand`; `` + +#### execaCommand(command, options?) -Execute a file. Think of this as a mix of [`child_process.execFile()`](https://nodejs.org/api/child_process.html#child_process_child_process_execfile_file_args_options_callback) and [`child_process.spawn()`](https://nodejs.org/api/child_process.html#child_process_child_process_spawn_command_args_options). +Executes a command. The `command` string includes both the `file` and its `arguments`. Returns a [`childProcess`](#childprocess). -No escaping/quoting is needed. +Arguments are [automatically escaped](#shell-syntax). They can contain any character, but spaces must be escaped with a backslash like `execaCommand('echo has\\ space')`. -Unless the [`shell`](#shell) option is used, no shell interpreter (Bash, `cmd.exe`, etc.) is used, so shell features such as variables substitution (`echo $PATH`) are not allowed. +This is the preferred method when executing a user-supplied `command` string, such as in a REPL. -Returns a [`child_process` instance](https://nodejs.org/api/child_process.html#child_process_class_childprocess) which: - - is also a `Promise` resolving or rejecting with a [`childProcessResult`](#childProcessResult). - - exposes the following additional methods and properties. +### execaSync(file, arguments?, options?) + +Same as [`execa()`](#execacommandcommand-options) but synchronous. + +Returns or throws a [`childProcessResult`](#childProcessResult). + +### $.sync\`command\` + +Same as [$\`command\`](#command) but synchronous. + +Returns or throws a [`childProcessResult`](#childProcessResult). + +### execaCommandSync(command, options?) + +Same as [`execaCommand()`](#execacommand-command-options) but synchronous. + +Returns or throws a [`childProcessResult`](#childProcessResult). + +### Shell syntax + +For all the [methods above](#methods), no shell interpreter (Bash, cmd.exe, etc.) is used unless the [`shell` option](#shell) is set. This means shell-specific characters and expressions (`$variable`, `&&`, `||`, `;`, `|`, etc.) have no special meaning and do not need to be escaped. + +### childProcess + +The return value of all [asynchronous methods](#methods) is both: + - a `Promise` resolving or rejecting with a [`childProcessResult`](#childProcessResult). + - a [`child_process` instance](https://nodejs.org/api/child_process.html#child_process_class_childprocess) with the following additional methods and properties. #### kill(signal?, options?) @@ -176,10 +296,6 @@ Milliseconds to wait for the child process to terminate before sending `SIGKILL` Can be disabled with `false`. -#### cancel() - -Similar to [`childProcess.kill()`](https://nodejs.org/api/child_process.html#child_process_subprocess_kill_signal). This is preferred when cancelling the child process execution as the error is more descriptive and [`childProcessResult.isCanceled`](#iscanceled) is set to `true`. - #### all Type: `ReadableStream | undefined` @@ -190,34 +306,28 @@ This is `undefined` if either: - the [`all` option](#all-2) is `false` (the default value) - both [`stdout`](#stdout-1) and [`stderr`](#stderr-1) options are set to [`'inherit'`, `'ipc'`, `Stream` or `integer`](https://nodejs.org/dist/latest-v6.x/docs/api/child_process.html#child_process_options_stdio) -### execa.sync(file, arguments?, options?) - -Execute a file synchronously. - -Returns or throws a [`childProcessResult`](#childProcessResult). - -### execa.command(command, options?) +#### pipeStdout(target) -Same as [`execa()`](#execafile-arguments-options) except both file and arguments are specified in a single `command` string. For example, `execa('echo', ['unicorns'])` is the same as `execa.command('echo unicorns')`. +[Pipe](https://nodejs.org/api/stream.html#readablepipedestination-options) the child process's `stdout` to `target`, which can be: + - Another [`execa()` return value](#pipe-multiple-processes) + - A [writable stream](#save-and-pipe-output-from-a-child-process) + - A [file path string](#redirect-output-to-a-file) -If the file or an argument contains spaces, they must be escaped with backslashes. This matters especially if `command` is not a constant but a variable, for example with `__dirname` or `process.cwd()`. Except for spaces, no escaping/quoting is needed. +If the `target` is another [`execa()` return value](#execacommandcommand-options), it is returned. Otherwise, the original `execa()` return value is returned. This allows chaining `pipeStdout()` then `await`ing the [final result](#childprocessresult). -The [`shell` option](#shell) must be used if the `command` uses shell-specific features (for example, `&&` or `||`), as opposed to being a simple `file` followed by its `arguments`. +The [`stdout` option](#stdout-1) must be kept as `pipe`, its default value. -### execa.commandSync(command, options?) +#### pipeStderr(target) -Same as [`execa.command()`](#execacommand-command-options) but synchronous. +Like [`pipeStdout()`](#pipestdouttarget) but piping the child process's `stderr` instead. -Returns or throws a [`childProcessResult`](#childProcessResult). +The [`stderr` option](#stderr-1) must be kept as `pipe`, its default value. -### execa.node(scriptPath, arguments?, options?) +#### pipeAll(target) -Execute a Node.js script as a child process. +Combines both [`pipeStdout()`](#pipestdouttarget) and [`pipeStderr()`](#pipestderrtarget). -Same as `execa('node', [scriptPath, ...arguments], options)` except (like [`child_process#fork()`](https://nodejs.org/api/child_process.html#child_process_child_process_fork_modulepath_args_options)): - - the current Node version and options are used. This can be overridden using the [`nodePath`](#nodepath-for-node-only) and [`nodeOptions`](#nodeoptions-for-node-only) options. - - the [`shell`](#shell) option cannot be used - - an extra channel [`ipc`](https://nodejs.org/api/child_process.html#child_process_options_stdio) is passed to [`stdio`](#stdio) +Either the [`stdout` option](#stdout-1) or the [`stderr` option](#stderr-1) must be kept as `pipe`, their default value. Also, the [`all` option](#all-2) must be set to `true`. ### childProcessResult @@ -238,16 +348,16 @@ Type: `string` The file and arguments that were run, for logging purposes. -This is not escaped and should not be executed directly as a process, including using [`execa()`](#execafile-arguments-options) or [`execa.command()`](#execacommandcommand-options). +This is not escaped and should not be executed directly as a process, including using [`execa()`](#execafile-arguments-options) or [`execaCommand()`](#execacommandcommand-options). #### escapedCommand Type: `string` -Same as [`command`](#command) but escaped. +Same as [`command`](#command-1) but escaped. This is meant to be copy and pasted into a shell, for debugging purposes. -Since the escaping is fairly basic, this should not be executed directly as a process, including using [`execa()`](#execafile-arguments-options) or [`execa.command()`](#execacommandcommand-options). +Since the escaping is fairly basic, this should not be executed directly as a process, including using [`execa()`](#execafile-arguments-options) or [`execaCommand()`](#execacommandcommand-options). #### exitCode @@ -275,7 +385,7 @@ The output of the process with `stdout` and `stderr` interleaved. This is `undefined` if either: - the [`all` option](#all-2) is `false` (the default value) - - `execa.sync()` was used + - `execaSync()` was used #### failed @@ -295,6 +405,8 @@ Type: `boolean` Whether the process was canceled. +You can cancel the spawned process using the [`signal`](#signal-1) option. + #### killed Type: `boolean` @@ -355,14 +467,14 @@ Kill the spawned process when the parent process exits unless either: #### preferLocal Type: `boolean`\ -Default: `false` +Default: `true` with [`$`](#command)/[`$.sync`](#synccommand), `false` otherwise Prefer locally installed binaries when looking for a binary to execute.\ If you `$ npm install foo`, you can then `execa('foo')`. #### localDir -Type: `string`\ +Type: `string | URL`\ Default: `process.cwd()` Preferred path to find locally installed binaries in (use with `preferLocal`). @@ -396,6 +508,16 @@ Type: `string | Buffer | stream.Readable` Write some input to the `stdin` of your binary.\ Streams are not allowed when using the synchronous methods. +If the input is a file, use the [`inputFile` option](#inputfile) instead. + +#### inputFile + +Type: `string` + +Use a file as input to the the `stdin` of your binary. + +If the input is not a file, use the [`input` option](#input) instead. + #### stdin Type: `string | number | Stream | undefined`\ @@ -451,7 +573,7 @@ Execa also accepts the below options which are the same as the options for [`chi #### cwd -Type: `string`\ +Type: `string | URL`\ Default: `process.cwd()` Current working directory of the child process. @@ -481,12 +603,10 @@ Child's [stdio](https://nodejs.org/api/child_process.html#child_process_options_ Type: `string`\ Default: `'json'` -Specify the kind of serialization used for sending messages between processes when using the [`stdio: 'ipc'`](#stdio) option or [`execa.node()`](#execanodescriptpath-arguments-options): +Specify the kind of serialization used for sending messages between processes when using the [`stdio: 'ipc'`](#stdio) option or [`execaNode()`](#execanodescriptpath-arguments-options): - `json`: Uses `JSON.stringify()` and `JSON.parse()`. - `advanced`: Uses [`v8.serialize()`](https://nodejs.org/api/v8.html#v8_v8_serialize_value) -Requires Node.js `13.2.0` or later. - [More info.](https://nodejs.org/api/child_process.html#child_process_advanced_serialization) #### detached @@ -547,6 +667,16 @@ Default: `SIGTERM` Signal value to be used when the spawned process will be killed. +#### signal + +Type: [`AbortSignal`](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) + +You can abort the spawned process using [`AbortController`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController). + +When `AbortController.abort()` is called, [`.isCanceled`](#iscanceled) becomes `false`. + +*Requires Node.js 16 or later.* + #### windowsVerbatimArguments Type: `boolean`\ @@ -561,6 +691,15 @@ Default: `true` On Windows, do not create a new console window. Please note this also prevents `CTRL-C` [from working](https://github.com/nodejs/node/issues/29837) on Windows. +#### verbose + +Type: `boolean`\ +Default: `false` + +[Print each command](#verbose-mode) on `stderr` before executing it. + +This can also be enabled by setting the `NODE_DEBUG=execa` environment variable in the current process. + #### nodePath *(For `.node()` only)* Type: `string`\ @@ -582,59 +721,43 @@ List of [CLI options](https://nodejs.org/api/cli.html#cli_options) passed to the Gracefully handle failures by using automatic retries and exponential backoff with the [`p-retry`](https://github.com/sindresorhus/p-retry) package: ```js -const pRetry = require('p-retry'); +import pRetry from 'p-retry'; const run = async () => { const results = await execa('curl', ['-sSL', 'https://sindresorhus.com/unicorn']); return results; }; -(async () => { - console.log(await pRetry(run, {retries: 5})); -})(); +console.log(await pRetry(run, {retries: 5})); ``` -### Save and pipe output from a child process - -Let's say you want to show the output of a child process in real-time while also saving it to a variable. - -```js -const execa = require('execa'); - -const subprocess = execa('echo', ['foo']); -subprocess.stdout.pipe(process.stdout); - -(async () => { - const {stdout} = await subprocess; - console.log('child output:', stdout); -})(); -``` - -### Redirect output to a file +### Cancelling a spawned process ```js -const execa = require('execa'); +import {execa} from 'execa'; -const subprocess = execa('echo', ['foo']) -subprocess.stdout.pipe(fs.createWriteStream('stdout.txt')) -``` - -### Redirect input from a file +const abortController = new AbortController(); +const subprocess = execa('node', [], {signal: abortController.signal}); -```js -const execa = require('execa'); +setTimeout(() => { + abortController.abort(); +}, 1000); -const subprocess = execa('cat') -fs.createReadStream('stdin.txt').pipe(subprocess.stdin) +try { + await subprocess; +} catch (error) { + console.log(subprocess.killed); // true + console.log(error.isCanceled); // true +} ``` ### Execute the current package's binary ```js -const {getBinPathSync} = require('get-bin-path'); +import {getBinPath} from 'get-bin-path'; -const binPath = getBinPathSync(); -const subprocess = execa(binPath); +const binPath = await getBinPath(); +await execa(binPath); ``` `execa` can be combined with [`get-bin-path`](https://github.com/ehmicky/get-bin-path) to test the current package's binary. As opposed to hard-coding the path to the binary, this validates that the `package.json` `bin` field is correctly set up. diff --git a/node_modules/execa/node_modules/get-stream/buffer-stream.js b/node_modules/get-stream/buffer-stream.js similarity index 100% rename from node_modules/execa/node_modules/get-stream/buffer-stream.js rename to node_modules/get-stream/buffer-stream.js diff --git a/node_modules/execa/node_modules/get-stream/index.d.ts b/node_modules/get-stream/index.d.ts similarity index 100% rename from node_modules/execa/node_modules/get-stream/index.d.ts rename to node_modules/get-stream/index.d.ts diff --git a/node_modules/execa/node_modules/get-stream/index.js b/node_modules/get-stream/index.js similarity index 100% rename from node_modules/execa/node_modules/get-stream/index.js rename to node_modules/get-stream/index.js diff --git a/node_modules/execa/node_modules/get-stream/license b/node_modules/get-stream/license similarity index 100% rename from node_modules/execa/node_modules/get-stream/license rename to node_modules/get-stream/license diff --git a/node_modules/execa/node_modules/get-stream/package.json b/node_modules/get-stream/package.json similarity index 100% rename from node_modules/execa/node_modules/get-stream/package.json rename to node_modules/get-stream/package.json diff --git a/node_modules/execa/node_modules/get-stream/readme.md b/node_modules/get-stream/readme.md similarity index 100% rename from node_modules/execa/node_modules/get-stream/readme.md rename to node_modules/get-stream/readme.md diff --git a/node_modules/human-signals/CHANGELOG.md b/node_modules/human-signals/CHANGELOG.md deleted file mode 100644 index 70d039293..000000000 --- a/node_modules/human-signals/CHANGELOG.md +++ /dev/null @@ -1,11 +0,0 @@ -# 2.1.0 - -## TypeScript types - -- Add [TypeScript definitions](src/main.d.ts) - -# 2.0.0 - -## Breaking changes - -- Minimal supported Node.js version is now `10.17.0` diff --git a/node_modules/human-signals/LICENSE b/node_modules/human-signals/LICENSE index 9af949261..642f59b66 100644 --- a/node_modules/human-signals/LICENSE +++ b/node_modules/human-signals/LICENSE @@ -186,7 +186,7 @@ same "printed page" as the copyright notice for easier identification within third-party archives. - Copyright 2019 ehmicky
-- -> Make a function mimic another one - -Useful when you wrap a function in another function and like to preserve the original name and other properties. - -## Install - -``` -$ npm install mimic-fn -``` - -## Usage - -```js -import mimicFunction from 'mimic-fn'; - -function foo() {} -foo.unicorn = '🦄'; - -function wrapper() { - return foo(); -} - -console.log(wrapper.name); -//=> 'wrapper' - -mimicFunction(wrapper, foo); - -console.log(wrapper.name); -//=> 'foo' - -console.log(wrapper.unicorn); -//=> '🦄' - -console.log(String(wrapper)); -//=> '/* Wrapped with wrapper() */\nfunction foo() {}' -``` - - -## API - -### mimicFunction(to, from, options?) - -Modifies the `to` function to mimic the `from` function. Returns the `to` function. - -`name`, `displayName`, and any other properties of `from` are copied. The `length` property is not copied. Prototype, class, and inherited properties are copied. - -`to.toString()` will return the same as `from.toString()` but prepended with a `Wrapped with to()` comment. - -#### to - -Type: `Function` - -Mimicking function. - -#### from - -Type: `Function` - -Function to mimic. - -#### options - -Type: `object` - -##### ignoreNonConfigurable - -Type: `boolean`\ -Default: `false` - -Skip modifying [non-configurable properties](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertyDescriptor#Description) instead of throwing an error. - -## Related - -- [rename-fn](https://github.com/sindresorhus/rename-fn) - Rename a function -- [keep-func-props](https://github.com/ehmicky/keep-func-props) - Wrap a function without changing its name and other properties - ---- - -
-
- Get professional support for this package with a Tidelift subscription
-
-
- - Tidelift helps make open source sustainable for maintainers while giving companies
assurances about security, maintenance, and licensing for their dependencies. - -
diff --git a/node_modules/mimic-fn/index.d.ts b/node_modules/mimic-fn/index.d.ts
index b4047d589..2a72e0a56 100644
--- a/node_modules/mimic-fn/index.d.ts
+++ b/node_modules/mimic-fn/index.d.ts
@@ -1,54 +1,52 @@
-declare const mimicFn: {
+export interface Options {
/**
- Make a function mimic another one. It will copy over the properties `name`, `length`, `displayName`, and any custom properties you may have set.
+ Skip modifying [non-configurable properties](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertyDescriptor#Description) instead of throwing an error.
- @param to - Mimicking function.
- @param from - Function to mimic.
- @returns The modified `to` function.
+ @default false
+ */
+ readonly ignoreNonConfigurable?: boolean;
+}
- @example
- ```
- import mimicFn = require('mimic-fn');
+/**
+Modifies the `to` function to mimic the `from` function. Returns the `to` function.
- function foo() {}
- foo.unicorn = '🦄';
+`name`, `displayName`, and any other properties of `from` are copied. The `length` property is not copied. Prototype, class, and inherited properties are copied.
- function wrapper() {
- return foo();
- }
+`to.toString()` will return the same as `from.toString()` but prepended with a `Wrapped with to()` comment.
- console.log(wrapper.name);
- //=> 'wrapper'
+@param to - Mimicking function.
+@param from - Function to mimic.
+@returns The modified `to` function.
- mimicFn(wrapper, foo);
+@example
+```
+import mimicFunction from 'mimic-fn';
- console.log(wrapper.name);
- //=> 'foo'
+function foo() {}
+foo.unicorn = '🦄';
- console.log(wrapper.unicorn);
- //=> '🦄'
- ```
- */
- <
- ArgumentsType extends unknown[],
- ReturnType,
- FunctionType extends (...arguments: ArgumentsType) => ReturnType
- >(
- to: (...arguments: ArgumentsType) => ReturnType,
- from: FunctionType
- ): FunctionType;
-
- // TODO: Remove this for the next major release, refactor the whole definition to:
- // declare function mimicFn<
- // ArgumentsType extends unknown[],
- // ReturnType,
- // FunctionType extends (...arguments: ArgumentsType) => ReturnType
- // >(
- // to: (...arguments: ArgumentsType) => ReturnType,
- // from: FunctionType
- // ): FunctionType;
- // export = mimicFn;
- default: typeof mimicFn;
-};
-
-export = mimicFn;
+function wrapper() {
+ return foo();
+}
+
+console.log(wrapper.name);
+//=> 'wrapper'
+
+mimicFunction(wrapper, foo);
+
+console.log(wrapper.name);
+//=> 'foo'
+
+console.log(wrapper.unicorn);
+//=> '🦄'
+```
+*/
+export default function mimicFunction<
+ ArgumentsType extends unknown[],
+ ReturnType,
+ FunctionType extends (...arguments: ArgumentsType) => ReturnType
+>(
+ to: (...arguments: ArgumentsType) => ReturnType,
+ from: FunctionType,
+ options?: Options,
+): FunctionType;
diff --git a/node_modules/mimic-fn/index.js b/node_modules/mimic-fn/index.js
index 1a5970517..bc9ef7d56 100644
--- a/node_modules/mimic-fn/index.js
+++ b/node_modules/mimic-fn/index.js
@@ -1,13 +1,71 @@
-'use strict';
+const copyProperty = (to, from, property, ignoreNonConfigurable) => {
+ // `Function#length` should reflect the parameters of `to` not `from` since we keep its body.
+ // `Function#prototype` is non-writable and non-configurable so can never be modified.
+ if (property === 'length' || property === 'prototype') {
+ return;
+ }
-const mimicFn = (to, from) => {
- for (const prop of Reflect.ownKeys(from)) {
- Object.defineProperty(to, prop, Object.getOwnPropertyDescriptor(from, prop));
+ // `Function#arguments` and `Function#caller` should not be copied. They were reported to be present in `Reflect.ownKeys` for some devices in React Native (#41), so we explicitly ignore them here.
+ if (property === 'arguments' || property === 'caller') {
+ return;
}
- return to;
+ const toDescriptor = Object.getOwnPropertyDescriptor(to, property);
+ const fromDescriptor = Object.getOwnPropertyDescriptor(from, property);
+
+ if (!canCopyProperty(toDescriptor, fromDescriptor) && ignoreNonConfigurable) {
+ return;
+ }
+
+ Object.defineProperty(to, property, fromDescriptor);
+};
+
+// `Object.defineProperty()` throws if the property exists, is not configurable and either:
+// - one its descriptors is changed
+// - it is non-writable and its value is changed
+const canCopyProperty = function (toDescriptor, fromDescriptor) {
+ return toDescriptor === undefined || toDescriptor.configurable || (
+ toDescriptor.writable === fromDescriptor.writable &&
+ toDescriptor.enumerable === fromDescriptor.enumerable &&
+ toDescriptor.configurable === fromDescriptor.configurable &&
+ (toDescriptor.writable || toDescriptor.value === fromDescriptor.value)
+ );
+};
+
+const changePrototype = (to, from) => {
+ const fromPrototype = Object.getPrototypeOf(from);
+ if (fromPrototype === Object.getPrototypeOf(to)) {
+ return;
+ }
+
+ Object.setPrototypeOf(to, fromPrototype);
+};
+
+const wrappedToString = (withName, fromBody) => `/* Wrapped ${withName}*/\n${fromBody}`;
+
+const toStringDescriptor = Object.getOwnPropertyDescriptor(Function.prototype, 'toString');
+const toStringName = Object.getOwnPropertyDescriptor(Function.prototype.toString, 'name');
+
+// We call `from.toString()` early (not lazily) to ensure `from` can be garbage collected.
+// We use `bind()` instead of a closure for the same reason.
+// Calling `from.toString()` early also allows caching it in case `to.toString()` is called several times.
+const changeToString = (to, from, name) => {
+ const withName = name === '' ? '' : `with ${name.trim()}() `;
+ const newToString = wrappedToString.bind(null, withName, from.toString());
+ // Ensure `to.toString.toString` is non-enumerable and has the same `same`
+ Object.defineProperty(newToString, 'name', toStringName);
+ Object.defineProperty(to, 'toString', {...toStringDescriptor, value: newToString});
};
-module.exports = mimicFn;
-// TODO: Remove this for the next major release
-module.exports.default = mimicFn;
+export default function mimicFunction(to, from, {ignoreNonConfigurable = false} = {}) {
+ const {name} = to;
+
+ for (const property of Reflect.ownKeys(from)) {
+ copyProperty(to, from, property, ignoreNonConfigurable);
+ }
+
+ changePrototype(to, from);
+ changeToString(to, from, name);
+
+ return to;
+}
diff --git a/node_modules/mimic-fn/license b/node_modules/mimic-fn/license
index e7af2f771..fa7ceba3e 100644
--- a/node_modules/mimic-fn/license
+++ b/node_modules/mimic-fn/license
@@ -1,6 +1,6 @@
MIT License
-Copyright (c) Sindre Sorhus - - Tidelift helps make open source sustainable for maintainers while giving companies
assurances about security, maintenance, and licensing for their dependencies. - -
+> Make a function mimic another one Useful when you wrap a function in another function and like to preserve the original name and other properties. - ## Install ``` $ npm install mimic-fn ``` - ## Usage ```js -const mimicFn = require('mimic-fn'); +import mimicFunction from 'mimic-fn'; function foo() {} foo.unicorn = '🦄'; @@ -27,23 +26,28 @@ function wrapper() { console.log(wrapper.name); //=> 'wrapper' -mimicFn(wrapper, foo); +mimicFunction(wrapper, foo); console.log(wrapper.name); //=> 'foo' console.log(wrapper.unicorn); //=> '🦄' + +console.log(String(wrapper)); +//=> '/* Wrapped with wrapper() */\nfunction foo() {}' ``` ## API -It will copy over the properties `name`, `length`, `displayName`, and any custom properties you may have set. +### mimicFunction(to, from, options?) -### mimicFn(to, from) +Modifies the `to` function to mimic the `from` function. Returns the `to` function. -Modifies the `to` function and returns it. +`name`, `displayName`, and any other properties of `from` are copied. The `length` property is not copied. Prototype, class, and inherited properties are copied. + +`to.toString()` will return the same as `from.toString()` but prepended with a `Wrapped with to()` comment. #### to @@ -57,13 +61,30 @@ Type: `Function` Function to mimic. +#### options -## Related +Type: `object` -- [rename-fn](https://github.com/sindresorhus/rename-fn) - Rename a function -- [keep-func-props](https://github.com/ehmicky/keep-func-props) - Wrap a function without changing its name, length and other properties +##### ignoreNonConfigurable + +Type: `boolean`\ +Default: `false` +Skip modifying [non-configurable properties](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertyDescriptor#Description) instead of throwing an error. -## License +## Related -MIT © [Sindre Sorhus](https://sindresorhus.com) +- [rename-fn](https://github.com/sindresorhus/rename-fn) - Rename a function +- [keep-func-props](https://github.com/ehmicky/keep-func-props) - Wrap a function without changing its name and other properties + +--- + +
+
+ Get professional support for this package with a Tidelift subscription
+
+
+ + Tidelift helps make open source sustainable for maintainers while giving companies
assurances about security, maintenance, and licensing for their dependencies. + +
diff --git a/node_modules/npm-run-path/index.d.ts b/node_modules/npm-run-path/index.d.ts
index af10d41a6..fad851b89 100644
--- a/node_modules/npm-run-path/index.d.ts
+++ b/node_modules/npm-run-path/index.d.ts
@@ -1,89 +1,84 @@
-declare namespace npmRunPath {
- interface RunPathOptions {
- /**
- Working directory.
+export interface RunPathOptions {
+ /**
+ Working directory.
- @default process.cwd()
- */
- readonly cwd?: string;
+ @default process.cwd()
+ */
+ readonly cwd?: string | URL;
- /**
- PATH to be appended. Default: [`PATH`](https://github.com/sindresorhus/path-key).
+ /**
+ PATH to be appended. Default: [`PATH`](https://github.com/sindresorhus/path-key).
- Set it to an empty string to exclude the default PATH.
- */
- readonly path?: string;
+ Set it to an empty string to exclude the default PATH.
+ */
+ readonly path?: string;
- /**
- Path to the Node.js executable to use in child processes if that is different from the current one. Its directory is pushed to the front of PATH.
+ /**
+ Path to the Node.js executable to use in child processes if that is different from the current one. Its directory is pushed to the front of PATH.
- This can be either an absolute path or a path relative to the `cwd` option.
+ This can be either an absolute path or a path relative to the `cwd` option.
- @default process.execPath
- */
- readonly execPath?: string;
- }
+ @default process.execPath
+ */
+ readonly execPath?: string;
+}
- interface ProcessEnv {
- [key: string]: string | undefined;
- }
+export type ProcessEnv = Record+ + Tidelift helps make open source sustainable for maintainers while giving companies
assurances about security, maintenance, and licensing for their dependencies. + +
+
+ Get professional support for this package with a Tidelift subscription
+
+
+ + Tidelift helps make open source sustainable for maintainers while giving companies
assurances about security, maintenance, and licensing for their dependencies. + +
diff --git a/node_modules/npm-run-path/package.json b/node_modules/npm-run-path/package.json
index 39497091c..df46566e3 100644
--- a/node_modules/npm-run-path/package.json
+++ b/node_modules/npm-run-path/package.json
@@ -1,16 +1,19 @@
{
"name": "npm-run-path",
- "version": "4.0.1",
+ "version": "5.1.0",
"description": "Get your PATH prepended with locally installed binaries",
"license": "MIT",
"repository": "sindresorhus/npm-run-path",
+ "funding": "https://github.com/sponsors/sindresorhus",
"author": {
"name": "Sindre Sorhus",
"email": "sindresorhus@gmail.com",
- "url": "sindresorhus.com"
+ "url": "https://sindresorhus.com"
},
+ "type": "module",
+ "exports": "./index.js",
"engines": {
- "node": ">=8"
+ "node": "^12.20.0 || ^14.13.1 || >=16.0.0"
},
"scripts": {
"test": "xo && ava && tsd"
@@ -34,11 +37,11 @@
"executable"
],
"dependencies": {
- "path-key": "^3.0.0"
+ "path-key": "^4.0.0"
},
"devDependencies": {
- "ava": "^1.4.1",
- "tsd": "^0.7.2",
- "xo": "^0.24.0"
+ "ava": "^3.15.0",
+ "tsd": "^0.17.0",
+ "xo": "^0.45.0"
}
}
diff --git a/node_modules/npm-run-path/readme.md b/node_modules/npm-run-path/readme.md
index 557fbeb6c..f2ab84b80 100644
--- a/node_modules/npm-run-path/readme.md
+++ b/node_modules/npm-run-path/readme.md
@@ -1,22 +1,20 @@
-# npm-run-path [](https://travis-ci.org/sindresorhus/npm-run-path)
+# npm-run-path
> Get your [PATH](https://en.wikipedia.org/wiki/PATH_(variable)) prepended with locally installed binaries
In [npm run scripts](https://docs.npmjs.com/cli/run-script) you can execute locally installed binaries by name. This enables the same outside npm.
-
## Install
-```
-$ npm install npm-run-path
+```sh
+npm install npm-run-path
```
-
## Usage
```js
-const childProcess = require('child_process');
-const npmRunPath = require('npm-run-path');
+import childProcess from 'node:child_process';
+import {npmRunPath, npmRunPathEnv} from 'npm-run-path';
console.log(process.env.PATH);
//=> '/usr/local/bin'
@@ -26,16 +24,15 @@ console.log(npmRunPath());
// `foo` is a locally installed binary
childProcess.execFileSync('foo', {
- env: npmRunPath.env()
+ env: npmRunPathEnv()
});
```
-
## API
### npmRunPath(options?)
-Returns the augmented path string.
+Returns the augmented PATH string.
#### options
@@ -43,29 +40,30 @@ Type: `object`
##### cwd
-Type: `string`+ + Tidelift helps make open source sustainable for maintainers while giving companies
assurances about security, maintenance, and licensing for their dependencies. + +
+Type: `string | URL`\ Default: `process.cwd()` -Working directory. +The working directory. ##### path -Type: `string`
+Type: `string`\ Default: [`PATH`](https://github.com/sindresorhus/path-key) -PATH to be appended.
+The PATH to be appended. + Set it to an empty string to exclude the default PATH. ##### execPath -Type: `string`
+Type: `string`\ Default: `process.execPath` -Path to the current Node.js executable. Its directory is pushed to the front of PATH. +The path to the current Node.js executable. Its directory is pushed to the front of PATH. This can be either an absolute path or a path relative to the [`cwd` option](#cwd). -### npmRunPath.env(options?) +### npmRunPathEnv(options?) Returns the augmented [`process.env`](https://nodejs.org/api/process.html#process_process_env) object. @@ -75,33 +73,31 @@ Type: `object` ##### cwd -Type: `string`
+Type: `string | URL`\ Default: `process.cwd()` -Working directory. +The working directory. ##### env -Type: `Object` +Type: `object` Accepts an object of environment variables, like `process.env`, and modifies the PATH using the correct [PATH key](https://github.com/sindresorhus/path-key). Use this if you're modifying the PATH for use in the `child_process` options. ##### execPath -Type: `string`
+Type: `string`\ Default: `process.execPath` -Path to the Node.js executable to use in child processes if that is different from the current one. Its directory is pushed to the front of PATH. +The path to the Node.js executable to use in child processes if that is different from the current one. Its directory is pushed to the front of PATH. This can be either an absolute path or a path relative to the [`cwd` option](#cwd). - ## Related - [npm-run-path-cli](https://github.com/sindresorhus/npm-run-path-cli) - CLI for this module - [execa](https://github.com/sindresorhus/execa) - Execute a locally installed binary - ---
diff --git a/node_modules/onetime/index.d.ts b/node_modules/onetime/index.d.ts
index ea84caba3..3c80803f9 100644
--- a/node_modules/onetime/index.d.ts
+++ b/node_modules/onetime/index.d.ts
@@ -1,12 +1,10 @@
-declare namespace onetime {
- interface Options {
- /**
- Throw an error when called more than once.
+export interface Options {
+ /**
+ Throw an error when called more than once.
- @default false
- */
- throw?: boolean;
- }
+ @default false
+ */
+ readonly throw?: boolean;
}
declare const onetime: {
@@ -18,11 +16,11 @@ declare const onetime: {
@example
```
- import onetime = require('onetime');
+ import onetime from 'onetime';
- let i = 0;
+ let index = 0;
- const foo = onetime(() => ++i);
+ const foo = onetime(() => ++index);
foo(); //=> 1
foo(); //=> 1
@@ -33,7 +31,7 @@ declare const onetime: {
*/
(
fn: (...arguments: ArgumentsType) => ReturnType,
- options?: onetime.Options
+ options?: Options
): (...arguments: ArgumentsType) => ReturnType;
/**
@@ -44,7 +42,7 @@ declare const onetime: {
@example
```
- import onetime = require('onetime');
+ import onetime from 'onetime';
const foo = onetime(() => {});
foo();
@@ -56,9 +54,6 @@ declare const onetime: {
```
*/
callCount(fn: (...arguments: any[]) => unknown): number;
-
- // TODO: Remove this for the next major release
- default: typeof onetime;
};
-export = onetime;
+export default onetime;
diff --git a/node_modules/onetime/index.js b/node_modules/onetime/index.js
index 99c5fc1cb..eae4f33e4 100644
--- a/node_modules/onetime/index.js
+++ b/node_modules/onetime/index.js
@@ -1,5 +1,4 @@
-'use strict';
-const mimicFn = require('mimic-fn');
+import mimicFunction from 'mimic-fn';
const calledFunctions = new WeakMap();
@@ -25,20 +24,18 @@ const onetime = (function_, options = {}) => {
return returnValue;
};
- mimicFn(onetime, function_);
+ mimicFunction(onetime, function_);
calledFunctions.set(onetime, callCount);
return onetime;
};
-module.exports = onetime;
-// TODO: Remove this for the next major release
-module.exports.default = onetime;
-
-module.exports.callCount = function_ => {
+onetime.callCount = function_ => {
if (!calledFunctions.has(function_)) {
throw new Error(`The given function \`${function_.name}\` is not wrapped by the \`onetime\` package`);
}
return calledFunctions.get(function_);
};
+
+export default onetime;
diff --git a/node_modules/onetime/package.json b/node_modules/onetime/package.json
index c4fe4e245..367a96349 100644
--- a/node_modules/onetime/package.json
+++ b/node_modules/onetime/package.json
@@ -1,6 +1,6 @@
{
"name": "onetime",
- "version": "5.1.2",
+ "version": "6.0.0",
"description": "Ensure a function is only called once",
"license": "MIT",
"repository": "sindresorhus/onetime",
@@ -10,8 +10,10 @@
"email": "sindresorhus@gmail.com",
"url": "https://sindresorhus.com"
},
+ "type": "module",
+ "exports": "./index.js",
"engines": {
- "node": ">=6"
+ "node": ">=12"
},
"scripts": {
"test": "xo && ava && tsd"
@@ -33,11 +35,11 @@
"prevent"
],
"dependencies": {
- "mimic-fn": "^2.1.0"
+ "mimic-fn": "^4.0.0"
},
"devDependencies": {
- "ava": "^1.4.1",
- "tsd": "^0.7.1",
- "xo": "^0.24.0"
+ "ava": "^3.15.0",
+ "tsd": "^0.14.0",
+ "xo": "^0.38.2"
}
}
diff --git a/node_modules/onetime/readme.md b/node_modules/onetime/readme.md
index 2d133d3a0..e2b26fb3d 100644
--- a/node_modules/onetime/readme.md
+++ b/node_modules/onetime/readme.md
@@ -1,4 +1,4 @@
-# onetime [](https://travis-ci.com/github/sindresorhus/onetime)
+# onetime
> Ensure a function is only called once
@@ -15,11 +15,11 @@ $ npm install onetime
## Usage
```js
-const onetime = require('onetime');
+import onetime from 'onetime';
-let i = 0;
+let index = 0;
-const foo = onetime(() => ++i);
+const foo = onetime(() => ++index);
foo(); //=> 1
foo(); //=> 1
@@ -29,7 +29,7 @@ onetime.callCount(foo); //=> 3
```
```js
-const onetime = require('onetime');
+import onetime from 'onetime';
const foo = onetime(() => {}, {throw: true});
@@ -69,7 +69,7 @@ Returns a number representing how many times `fn` has been called.
Note: It throws an error if you pass in a function that is not wrapped by `onetime`.
```js
-const onetime = require('onetime');
+import onetime from 'onetime';
const foo = onetime(() => {});
diff --git a/node_modules/strip-final-newline/index.js b/node_modules/strip-final-newline/index.js
index 78fc0c593..034b56f86 100644
--- a/node_modules/strip-final-newline/index.js
+++ b/node_modules/strip-final-newline/index.js
@@ -1,16 +1,14 @@
-'use strict';
-
-module.exports = input => {
+export default function stripFinalNewline(input) {
const LF = typeof input === 'string' ? '\n' : '\n'.charCodeAt();
const CR = typeof input === 'string' ? '\r' : '\r'.charCodeAt();
if (input[input.length - 1] === LF) {
- input = input.slice(0, input.length - 1);
+ input = input.slice(0, -1);
}
if (input[input.length - 1] === CR) {
- input = input.slice(0, input.length - 1);
+ input = input.slice(0, -1);
}
return input;
-};
+}
diff --git a/node_modules/strip-final-newline/license b/node_modules/strip-final-newline/license
index e7af2f771..fa7ceba3e 100644
--- a/node_modules/strip-final-newline/license
+++ b/node_modules/strip-final-newline/license
@@ -1,6 +1,6 @@
MIT License
-Copyright (c) Sindre Sorhus (sindresorhus.com)
+Copyright (c) Sindre Sorhus (https://sindresorhus.com)
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:
diff --git a/node_modules/strip-final-newline/package.json b/node_modules/strip-final-newline/package.json
index 40b7e802c..23ac8622e 100644
--- a/node_modules/strip-final-newline/package.json
+++ b/node_modules/strip-final-newline/package.json
@@ -1,16 +1,19 @@
{
"name": "strip-final-newline",
- "version": "2.0.0",
+ "version": "3.0.0",
"description": "Strip the final newline character from a string/buffer",
"license": "MIT",
"repository": "sindresorhus/strip-final-newline",
+ "funding": "https://github.com/sponsors/sindresorhus",
"author": {
"name": "Sindre Sorhus",
"email": "sindresorhus@gmail.com",
- "url": "sindresorhus.com"
+ "url": "https://sindresorhus.com"
},
+ "type": "module",
+ "exports": "./index.js",
"engines": {
- "node": ">=6"
+ "node": ">=12"
},
"scripts": {
"test": "xo && ava"
@@ -34,7 +37,7 @@
"buffer"
],
"devDependencies": {
- "ava": "^0.25.0",
- "xo": "^0.23.0"
+ "ava": "^3.15.0",
+ "xo": "^0.39.1"
}
}
diff --git a/node_modules/strip-final-newline/readme.md b/node_modules/strip-final-newline/readme.md
index 32dfd5090..8d9090b64 100644
--- a/node_modules/strip-final-newline/readme.md
+++ b/node_modules/strip-final-newline/readme.md
@@ -1,21 +1,19 @@
-# strip-final-newline [](https://travis-ci.com/sindresorhus/strip-final-newline)
+# strip-final-newline
> Strip the final [newline character](https://en.wikipedia.org/wiki/Newline) from a string/buffer
Can be useful when parsing the output of, for example, `ChildProcess#execFile`, as [binaries usually output a newline at the end](https://stackoverflow.com/questions/729692/why-should-text-files-end-with-a-newline). Normally, you would use `stdout.trim()`, but that would also remove newlines at the start and whitespace.
-
## Install
```
$ npm install strip-final-newline
```
-
## Usage
```js
-const stripFinalNewline = require('strip-final-newline');
+import stripFinalNewline from 'strip-final-newline';
stripFinalNewline('foo\nbar\n\n');
//=> 'foo\nbar\n'
@@ -24,7 +22,14 @@ stripFinalNewline(Buffer.from('foo\nbar\n\n')).toString();
//=> 'foo\nbar\n'
```
-
-## License
-
-MIT © [Sindre Sorhus](https://sindresorhus.com)
+---
+
+
+
+ Get professional support for this package with a Tidelift subscription
+
+
+ + Tidelift helps make open source sustainable for maintainers while giving companies
assurances about security, maintenance, and licensing for their dependencies. + +
diff --git a/package-lock.json b/package-lock.json
index 3c8ef940b..155ccffb6 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -40,7 +40,7 @@
"zlib": "^1.0.5"
},
"devDependencies": {
- "@ava/typescript": "3.0.1",
+ "@ava/typescript": "4.0.0",
"@types/adm-zip": "^0.5.0",
"@types/get-folder-size": "^2.0.0",
"@types/js-yaml": "^4.0.5",
@@ -201,16 +201,16 @@
}
},
"node_modules/@ava/typescript": {
- "version": "3.0.1",
- "resolved": "https://registry.npmjs.org/@ava/typescript/-/typescript-3.0.1.tgz",
- "integrity": "sha512-/JXIUuKsvkaneaiA9ckk3ksFTqvu0mDNlChASrTe2BnDsvMbhQdPWyqQjJ9WRJWVhhs5TWn1/0Pp1G6Rv8Syrw==",
+ "version": "4.0.0",
+ "resolved": "https://registry.npmjs.org/@ava/typescript/-/typescript-4.0.0.tgz",
+ "integrity": "sha512-QFIPeqkEbdvn7Pob0wVeYpeZD0eXd8nDYdCl+knJVaIJrHdF2fXa58vFaig26cmYwnsEN0KRNTYJKbqW1B0lfg==",
"dev": true,
"dependencies": {
"escape-string-regexp": "^5.0.0",
- "execa": "^5.1.1"
+ "execa": "^7.1.0"
},
"engines": {
- "node": ">=12.22 <13 || >=14.17 <15 || >=16.4 <17 || >=17"
+ "node": ">=14.19 <15 || >=16.15 <17 || >=18"
}
},
"node_modules/@ava/typescript/node_modules/escape-string-regexp": {
@@ -3102,40 +3102,28 @@
}
},
"node_modules/execa": {
- "version": "5.1.1",
- "resolved": "https://registry.npmjs.org/execa/-/execa-5.1.1.tgz",
- "integrity": "sha512-8uSpZZocAZRBAPIEINJj3Lo9HyGitllczc27Eh5YYojjMFMn8yHMDMaUHE2Jqfq05D/wucwI4JGURyXt1vchyg==",
+ "version": "7.1.0",
+ "resolved": "https://registry.npmjs.org/execa/-/execa-7.1.0.tgz",
+ "integrity": "sha512-T6nIJO3LHxUZ6ahVRaxXz9WLEruXLqdcluA+UuTptXmLM7nDAn9lx9IfkxPyzEL21583qSt4RmL44pO71EHaJQ==",
"dev": true,
"dependencies": {
"cross-spawn": "^7.0.3",
- "get-stream": "^6.0.0",
- "human-signals": "^2.1.0",
- "is-stream": "^2.0.0",
+ "get-stream": "^6.0.1",
+ "human-signals": "^4.3.0",
+ "is-stream": "^3.0.0",
"merge-stream": "^2.0.0",
- "npm-run-path": "^4.0.1",
- "onetime": "^5.1.2",
- "signal-exit": "^3.0.3",
- "strip-final-newline": "^2.0.0"
+ "npm-run-path": "^5.1.0",
+ "onetime": "^6.0.0",
+ "signal-exit": "^3.0.7",
+ "strip-final-newline": "^3.0.0"
},
"engines": {
- "node": ">=10"
+ "node": "^14.18.0 || ^16.14.0 || >=18.0.0"
},
"funding": {
"url": "https://github.com/sindresorhus/execa?sponsor=1"
}
},
- "node_modules/execa/node_modules/get-stream": {
- "version": "6.0.1",
- "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-6.0.1.tgz",
- "integrity": "sha512-ts6Wi+2j3jQjqi70w5AlN8DFnkSwC+MqmxEzdEALB2qXZYV3X/b1CTfgPLGJNMeAWxdPfU8FO1ms3NUfaHCPYg==",
- "dev": true,
- "engines": {
- "node": ">=10"
- },
- "funding": {
- "url": "https://github.com/sponsors/sindresorhus"
- }
- },
"node_modules/fast-deep-equal": {
"version": "3.1.3",
"integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q=="
@@ -3387,6 +3375,18 @@
"url": "https://github.com/sponsors/ljharb"
}
},
+ "node_modules/get-stream": {
+ "version": "6.0.1",
+ "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-6.0.1.tgz",
+ "integrity": "sha512-ts6Wi+2j3jQjqi70w5AlN8DFnkSwC+MqmxEzdEALB2qXZYV3X/b1CTfgPLGJNMeAWxdPfU8FO1ms3NUfaHCPYg==",
+ "dev": true,
+ "engines": {
+ "node": ">=10"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
+ }
+ },
"node_modules/get-symbol-description": {
"version": "1.0.0",
"resolved": "https://registry.npmjs.org/get-symbol-description/-/get-symbol-description-1.0.0.tgz",
@@ -3619,12 +3619,12 @@
}
},
"node_modules/human-signals": {
- "version": "2.1.0",
- "resolved": "https://registry.npmjs.org/human-signals/-/human-signals-2.1.0.tgz",
- "integrity": "sha512-B4FFZ6q/T2jhhksgkbEW3HBvWIfDW85snkQgawt07S7J5QXTk6BkNV+0yAeZrM5QpMAdYlocGoljn0sJ/WQkFw==",
+ "version": "4.3.0",
+ "resolved": "https://registry.npmjs.org/human-signals/-/human-signals-4.3.0.tgz",
+ "integrity": "sha512-zyzVyMjpGBX2+6cDVZeFPCdtOtdsxOeseRhB9tkQ6xXmGUNrcnBzdEKPy3VPNYz+4gy1oukVOXcrJCunSyc6QQ==",
"dev": true,
"engines": {
- "node": ">=10.17.0"
+ "node": ">=14.18.0"
}
},
"node_modules/ignore": {
@@ -3998,12 +3998,12 @@
}
},
"node_modules/is-stream": {
- "version": "2.0.1",
- "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-2.0.1.tgz",
- "integrity": "sha512-hFoiJiTl63nn+kstHGBtewWSKnQLpyb155KHheA1l39uvtO9nWIop1p3udqPcUd/xbF1VLMO4n7OI6p7RbngDg==",
+ "version": "3.0.0",
+ "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-3.0.0.tgz",
+ "integrity": "sha512-LnQR4bZ9IADDRSkvpqMGvt/tEJWclzklNgSw48V5EAaAeDd6qGvN8ei6k5p0tvxSR171VmGyHuTiAOfxAbr8kA==",
"dev": true,
"engines": {
- "node": ">=8"
+ "node": "^12.20.0 || ^14.13.1 || >=16.0.0"
},
"funding": {
"url": "https://github.com/sponsors/sindresorhus"
@@ -4400,18 +4400,6 @@
"url": "https://github.com/sindresorhus/mem?sponsor=1"
}
},
- "node_modules/mem/node_modules/mimic-fn": {
- "version": "4.0.0",
- "resolved": "https://registry.npmjs.org/mimic-fn/-/mimic-fn-4.0.0.tgz",
- "integrity": "sha512-vqiC06CuhBTUdZH+RYl8sFrL096vA45Ok5ISO6sE/Mr1jRbGH4Csnhi8f3wKVl7x8mO4Au7Ir9D3Oyv1VYMFJw==",
- "dev": true,
- "engines": {
- "node": ">=12"
- },
- "funding": {
- "url": "https://github.com/sponsors/sindresorhus"
- }
- },
"node_modules/merge-stream": {
"version": "2.0.0",
"resolved": "https://registry.npmjs.org/merge-stream/-/merge-stream-2.0.0.tgz",
@@ -4458,11 +4446,15 @@
}
},
"node_modules/mimic-fn": {
- "version": "2.1.0",
- "integrity": "sha512-OqbOk5oEQeAZ8WXWydlu9HJjz9WVdEIvamMCcXmuqUYjTknH/sqsWvhQ3vgwKFRR1HpjvNBKQ37nbJgYzGqGcg==",
+ "version": "4.0.0",
+ "resolved": "https://registry.npmjs.org/mimic-fn/-/mimic-fn-4.0.0.tgz",
+ "integrity": "sha512-vqiC06CuhBTUdZH+RYl8sFrL096vA45Ok5ISO6sE/Mr1jRbGH4Csnhi8f3wKVl7x8mO4Au7Ir9D3Oyv1VYMFJw==",
"dev": true,
"engines": {
- "node": ">=6"
+ "node": ">=12"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
}
},
"node_modules/minimatch": {
@@ -4599,15 +4591,30 @@
}
},
"node_modules/npm-run-path": {
- "version": "4.0.1",
- "resolved": "https://registry.npmjs.org/npm-run-path/-/npm-run-path-4.0.1.tgz",
- "integrity": "sha512-S48WzZW777zhNIrn7gxOlISNAqi9ZC/uQFnRdbeIHhZhCA6UqpkOT8T1G7BvfdgP4Er8gF4sUbaS0i7QvIfCWw==",
+ "version": "5.1.0",
+ "resolved": "https://registry.npmjs.org/npm-run-path/-/npm-run-path-5.1.0.tgz",
+ "integrity": "sha512-sJOdmRGrY2sjNTRMbSvluQqg+8X7ZK61yvzBEIDhz4f8z1TZFYABsqjjCBd/0PUNE9M6QDgHJXQkGUEm7Q+l9Q==",
"dev": true,
"dependencies": {
- "path-key": "^3.0.0"
+ "path-key": "^4.0.0"
},
"engines": {
- "node": ">=8"
+ "node": "^12.20.0 || ^14.13.1 || >=16.0.0"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
+ }
+ },
+ "node_modules/npm-run-path/node_modules/path-key": {
+ "version": "4.0.0",
+ "resolved": "https://registry.npmjs.org/path-key/-/path-key-4.0.0.tgz",
+ "integrity": "sha512-haREypq7xkM7ErfgIyA0z+Bj4AGKlMSdlQE2jvJo6huWD1EdkKYV+G/T4nq0YEF2vgTT8kqMFKo1uHn950r4SQ==",
+ "dev": true,
+ "engines": {
+ "node": ">=12"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
}
},
"node_modules/object-inspect": {
@@ -4718,15 +4725,15 @@
}
},
"node_modules/onetime": {
- "version": "5.1.2",
- "resolved": "https://registry.npmjs.org/onetime/-/onetime-5.1.2.tgz",
- "integrity": "sha512-kbpaSSGJTWdAY5KPVeMOKXSrPtr8C8C7wodJbcsd51jRnmD+GZu8Y0VoU6Dm5Z4vWr0Ig/1NKuWRKf7j5aaYSg==",
+ "version": "6.0.0",
+ "resolved": "https://registry.npmjs.org/onetime/-/onetime-6.0.0.tgz",
+ "integrity": "sha512-1FlR+gjXK7X+AsAHso35MnyN5KqGwJRi/31ft6x0M194ht7S+rWAvd7PHss9xSKMzE0asv1pyIHaJYq+BbacAQ==",
"dev": true,
"dependencies": {
- "mimic-fn": "^2.1.0"
+ "mimic-fn": "^4.0.0"
},
"engines": {
- "node": ">=6"
+ "node": ">=12"
},
"funding": {
"url": "https://github.com/sponsors/sindresorhus"
@@ -5563,12 +5570,15 @@
}
},
"node_modules/strip-final-newline": {
- "version": "2.0.0",
- "resolved": "https://registry.npmjs.org/strip-final-newline/-/strip-final-newline-2.0.0.tgz",
- "integrity": "sha512-BrpvfNAE3dcvq7ll3xVumzjKjZQ5tI1sEUIKr3Uoks0XUl45St3FlatVqef9prk4jRDzhW6WZg+3bk93y6pLjA==",
+ "version": "3.0.0",
+ "resolved": "https://registry.npmjs.org/strip-final-newline/-/strip-final-newline-3.0.0.tgz",
+ "integrity": "sha512-dOESqjYr96iWYylGObzd39EuNTa5VJxyvVAEm5Jnh7KGo75V43Hk1odPQkNDyXNmUR6k+gEiDVXnjB8HJ3crXw==",
"dev": true,
"engines": {
- "node": ">=6"
+ "node": ">=12"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
}
},
"node_modules/strip-json-comments": {
diff --git a/package.json b/package.json
index 3c57d7356..746580492 100644
--- a/package.json
+++ b/package.json
@@ -55,7 +55,7 @@
"micromatch is an unspecified dependency of ava"
],
"devDependencies": {
- "@ava/typescript": "3.0.1",
+ "@ava/typescript": "4.0.0",
"@types/adm-zip": "^0.5.0",
"@types/get-folder-size": "^2.0.0",
"@types/js-yaml": "^4.0.5",
+ + Tidelift helps make open source sustainable for maintainers while giving companies
assurances about security, maintenance, and licensing for their dependencies. + +