sindresorhus/execa (execa)
### [`v8.0.1`](https://togithub.com/sindresorhus/execa/releases/tag/v8.0.1)
[Compare Source](https://togithub.com/sindresorhus/execa/compare/v8.0.0...v8.0.1)
##### Fixes
- Fix and document support for the [`{encoding: 'buffer'}` option](https://togithub.com/sindresorhus/execa#encoding). It is the same as `{encoding: null}`, but preferred over it. ([#572](https://togithub.com/sindresorhus/execa/issues/572))
### [`v8.0.0`](https://togithub.com/sindresorhus/execa/releases/tag/v8.0.0)
[Compare Source](https://togithub.com/sindresorhus/execa/compare/v7.2.0...v8.0.0)
##### Breaking
- Require Node.js 16.17.0 and later ([#569](https://togithub.com/sindresorhus/execa/issues/569))
### [`v7.2.0`](https://togithub.com/sindresorhus/execa/releases/tag/v7.2.0)
[Compare Source](https://togithub.com/sindresorhus/execa/compare/v7.1.1...v7.2.0)
- Add `cwd` error property ([#565](https://togithub.com/sindresorhus/execa/issues/565)) [`f57fdec`](https://togithub.com/sindresorhus/execa/commit/f57fdec)
### [`v7.1.1`](https://togithub.com/sindresorhus/execa/releases/tag/v7.1.1)
[Compare Source](https://togithub.com/sindresorhus/execa/compare/v7.1.0...v7.1.1)
#### Features
- Improve error message when `` $.sync(options)`command` `` is used instead of [`` $(options).sync`command` ``](https://togithub.com/sindresorhus/execa#synccommand) ([#551](https://togithub.com/sindresorhus/execa/issues/551))
#### Bug fixes
- Fix argument concatenation when using [`` $`command argument${value}` ``](https://togithub.com/sindresorhus/execa#command) ([#553](https://togithub.com/sindresorhus/execa/issues/553))
- Fix default value of the [`stdin` option](https://togithub.com/sindresorhus/execa#stdin) when using [`` $`command` ``](https://togithub.com/sindresorhus/execa#command): it should be `inherit` ([#550](https://togithub.com/sindresorhus/execa/issues/550))
### [`v7.1.0`](https://togithub.com/sindresorhus/execa/releases/tag/v7.1.0)
[Compare Source](https://togithub.com/sindresorhus/execa/compare/v7.0.0...v7.1.0)
#### Features
- Add [`$` method](https://togithub.com/sindresorhus/execa#command) to write Node.js scripts like zx. For more information, please see [this blog post](https://medium.com/@ehmicky/shell-free-scripts-with-execa-7-885fb3b42f83), [this section](https://togithub.com/sindresorhus/execa#scripts-interface) and [this page](https://togithub.com/sindresorhus/execa/blob/main/docs/scripts.md). Thanks [@aaronccasanova](https://togithub.com/aaronccasanova) for this great feature!
```js
import {$} from 'execa';
const branch = await $`git branch --show-current`;
await $`dep deploy --branch=${branch}`;
```
- Add [`.pipeStdout()`](https://togithub.com/sindresorhus/execa#pipestdouttarget), [`.pipeStderr()`](https://togithub.com/sindresorhus/execa#pipestderrtarget) and [`.pipeAll()`](https://togithub.com/sindresorhus/execa#pipealltarget) methods to redirect `stdout`/`stderr` to a file, a stream or another process.
```js
// 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');
```
- Add [`inputFile` option](https://togithub.com/sindresorhus/execa#inputfile) to use a file as `stdin`.
```js
// Similar to `cat < stdin.txt` in Bash
const {stdout} = await execa('cat', {inputFile: 'stdin.txt'});
console.log(stdout);
//=> 'unicorns'
```
- Add [`verbose` option](https://togithub.com/sindresorhus/execa#verbose) to print each command on `stderr` before executing it. This can also be enabled by setting the `NODE_DEBUG=execa` environment variable in the current process.
> 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
### [`v7.0.0`](https://togithub.com/sindresorhus/execa/releases/tag/v7.0.0)
[Compare Source](https://togithub.com/sindresorhus/execa/compare/v6.1.0...v7.0.0)
##### Breaking
- Require Node.js 14 and later ([#497](https://togithub.com/sindresorhus/execa/issues/497)) [`a09cbc0`](https://togithub.com/sindresorhus/execa/commit/a09cbc0)
##### Fixes
- Emit `end` event on streams when process fails ([#518](https://togithub.com/sindresorhus/execa/issues/518)) [`30c7a7a`](https://togithub.com/sindresorhus/execa/commit/30c7a7a)
- Fix incorrect `execaNode` signature in `index.d.ts` ([#506](https://togithub.com/sindresorhus/execa/issues/506)) [`1f7677c`](https://togithub.com/sindresorhus/execa/commit/1f7677c)
### [`v6.1.0`](https://togithub.com/sindresorhus/execa/releases/tag/v6.1.0)
[Compare Source](https://togithub.com/sindresorhus/execa/compare/v6.0.0...v6.1.0)
- Support [`AbortController`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController) ([#490](https://togithub.com/sindresorhus/execa/issues/490)) [`c6e791a`](https://togithub.com/sindresorhus/execa/commit/c6e791a)
- Allow `cwd` and `localDir` options to be URLs ([#492](https://togithub.com/sindresorhus/execa/issues/492)) [`93ab929`](https://togithub.com/sindresorhus/execa/commit/93ab929)
### [`v6.0.0`](https://togithub.com/sindresorhus/execa/releases/tag/v6.0.0)
[Compare Source](https://togithub.com/sindresorhus/execa/compare/v5.1.1...v6.0.0)
##### Breaking
- Require Node.js 12.20 ([#478](https://togithub.com/sindresorhus/execa/issues/478)) [`7707880`](https://togithub.com/sindresorhus/execa/commit/7707880)
- This package is now pure ESM. **Please [read this](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c).**
- Moved from a default export to named exports.
- `require('execa')` → `import {execa} from 'execa'`
- `require('execa').sync` → `import {execaSync} from 'execa'`
- `require('execa').command` → `import {execaCommand} from 'execa'`
- `require('execa').commandSync` → `import {execaCommandSync} from 'execa'`
- `require('execa').node` → `import {execaNode} from 'execa'`
### [`v5.1.1`](https://togithub.com/sindresorhus/execa/releases/tag/v5.1.1)
[Compare Source](https://togithub.com/sindresorhus/execa/compare/v5.1.0...v5.1.1)
- Fix error message when user passes a single array argument ([#468](https://togithub.com/sindresorhus/execa/issues/468)) [`2b9c0e1`](https://togithub.com/sindresorhus/execa/commit/2b9c0e1)
### [`v5.1.0`](https://togithub.com/sindresorhus/execa/releases/tag/v5.1.0)
[Compare Source](https://togithub.com/sindresorhus/execa/compare/v5.0.1...v5.1.0)
- Add [`.escapedCommand`](https://togithub.com/sindresorhus/execa#escapedcommand) property to the results ([#466](https://togithub.com/sindresorhus/execa/issues/466)) [`712bafc`](https://togithub.com/sindresorhus/execa/commit/712bafc)
### [`v5.0.1`](https://togithub.com/sindresorhus/execa/releases/tag/v5.0.1)
[Compare Source](https://togithub.com/sindresorhus/execa/compare/v5.0.0...v5.0.1)
- Fix `timeout` option validation ([#463](https://togithub.com/sindresorhus/execa/issues/463)) [`427c5c2`](https://togithub.com/sindresorhus/execa/commit/427c5c2)
Configuration
📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
[ ] If you want to rebase/retry this PR, check this box
This PR has been generated by Mend Renovate. View repository job log here.
This PR contains the following updates:
^5.0.0->^8.0.1Release Notes
sindresorhus/execa (execa)
### [`v8.0.1`](https://togithub.com/sindresorhus/execa/releases/tag/v8.0.1) [Compare Source](https://togithub.com/sindresorhus/execa/compare/v8.0.0...v8.0.1) ##### Fixes - Fix and document support for the [`{encoding: 'buffer'}` option](https://togithub.com/sindresorhus/execa#encoding). It is the same as `{encoding: null}`, but preferred over it. ([#572](https://togithub.com/sindresorhus/execa/issues/572)) ### [`v8.0.0`](https://togithub.com/sindresorhus/execa/releases/tag/v8.0.0) [Compare Source](https://togithub.com/sindresorhus/execa/compare/v7.2.0...v8.0.0) ##### Breaking - Require Node.js 16.17.0 and later ([#569](https://togithub.com/sindresorhus/execa/issues/569)) ### [`v7.2.0`](https://togithub.com/sindresorhus/execa/releases/tag/v7.2.0) [Compare Source](https://togithub.com/sindresorhus/execa/compare/v7.1.1...v7.2.0) - Add `cwd` error property ([#565](https://togithub.com/sindresorhus/execa/issues/565)) [`f57fdec`](https://togithub.com/sindresorhus/execa/commit/f57fdec) ### [`v7.1.1`](https://togithub.com/sindresorhus/execa/releases/tag/v7.1.1) [Compare Source](https://togithub.com/sindresorhus/execa/compare/v7.1.0...v7.1.1) #### Features - Improve error message when `` $.sync(options)`command` `` is used instead of [`` $(options).sync`command` ``](https://togithub.com/sindresorhus/execa#synccommand) ([#551](https://togithub.com/sindresorhus/execa/issues/551)) #### Bug fixes - Fix argument concatenation when using [`` $`command argument${value}` ``](https://togithub.com/sindresorhus/execa#command) ([#553](https://togithub.com/sindresorhus/execa/issues/553)) - Fix default value of the [`stdin` option](https://togithub.com/sindresorhus/execa#stdin) when using [`` $`command` ``](https://togithub.com/sindresorhus/execa#command): it should be `inherit` ([#550](https://togithub.com/sindresorhus/execa/issues/550)) ### [`v7.1.0`](https://togithub.com/sindresorhus/execa/releases/tag/v7.1.0) [Compare Source](https://togithub.com/sindresorhus/execa/compare/v7.0.0...v7.1.0) #### Features - Add [`$` method](https://togithub.com/sindresorhus/execa#command) to write Node.js scripts like zx. For more information, please see [this blog post](https://medium.com/@ehmicky/shell-free-scripts-with-execa-7-885fb3b42f83), [this section](https://togithub.com/sindresorhus/execa#scripts-interface) and [this page](https://togithub.com/sindresorhus/execa/blob/main/docs/scripts.md). Thanks [@aaronccasanova](https://togithub.com/aaronccasanova) for this great feature! ```js import {$} from 'execa'; const branch = await $`git branch --show-current`; await $`dep deploy --branch=${branch}`; ``` - Add [`.pipeStdout()`](https://togithub.com/sindresorhus/execa#pipestdouttarget), [`.pipeStderr()`](https://togithub.com/sindresorhus/execa#pipestderrtarget) and [`.pipeAll()`](https://togithub.com/sindresorhus/execa#pipealltarget) methods to redirect `stdout`/`stderr` to a file, a stream or another process. ```js // 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'); ``` - Add [`inputFile` option](https://togithub.com/sindresorhus/execa#inputfile) to use a file as `stdin`. ```js // Similar to `cat < stdin.txt` in Bash const {stdout} = await execa('cat', {inputFile: 'stdin.txt'}); console.log(stdout); //=> 'unicorns' ``` - Add [`verbose` option](https://togithub.com/sindresorhus/execa#verbose) to print each command on `stderr` before executing it. This can also be enabled by setting the `NODE_DEBUG=execa` environment variable in the current process. > 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 ### [`v7.0.0`](https://togithub.com/sindresorhus/execa/releases/tag/v7.0.0) [Compare Source](https://togithub.com/sindresorhus/execa/compare/v6.1.0...v7.0.0) ##### Breaking - Require Node.js 14 and later ([#497](https://togithub.com/sindresorhus/execa/issues/497)) [`a09cbc0`](https://togithub.com/sindresorhus/execa/commit/a09cbc0) ##### Fixes - Emit `end` event on streams when process fails ([#518](https://togithub.com/sindresorhus/execa/issues/518)) [`30c7a7a`](https://togithub.com/sindresorhus/execa/commit/30c7a7a) - Fix incorrect `execaNode` signature in `index.d.ts` ([#506](https://togithub.com/sindresorhus/execa/issues/506)) [`1f7677c`](https://togithub.com/sindresorhus/execa/commit/1f7677c) ### [`v6.1.0`](https://togithub.com/sindresorhus/execa/releases/tag/v6.1.0) [Compare Source](https://togithub.com/sindresorhus/execa/compare/v6.0.0...v6.1.0) - Support [`AbortController`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController) ([#490](https://togithub.com/sindresorhus/execa/issues/490)) [`c6e791a`](https://togithub.com/sindresorhus/execa/commit/c6e791a) - Allow `cwd` and `localDir` options to be URLs ([#492](https://togithub.com/sindresorhus/execa/issues/492)) [`93ab929`](https://togithub.com/sindresorhus/execa/commit/93ab929) ### [`v6.0.0`](https://togithub.com/sindresorhus/execa/releases/tag/v6.0.0) [Compare Source](https://togithub.com/sindresorhus/execa/compare/v5.1.1...v6.0.0) ##### Breaking - Require Node.js 12.20 ([#478](https://togithub.com/sindresorhus/execa/issues/478)) [`7707880`](https://togithub.com/sindresorhus/execa/commit/7707880) - This package is now pure ESM. **Please [read this](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c).** - Moved from a default export to named exports. - `require('execa')` → `import {execa} from 'execa'` - `require('execa').sync` → `import {execaSync} from 'execa'` - `require('execa').command` → `import {execaCommand} from 'execa'` - `require('execa').commandSync` → `import {execaCommandSync} from 'execa'` - `require('execa').node` → `import {execaNode} from 'execa'` ### [`v5.1.1`](https://togithub.com/sindresorhus/execa/releases/tag/v5.1.1) [Compare Source](https://togithub.com/sindresorhus/execa/compare/v5.1.0...v5.1.1) - Fix error message when user passes a single array argument ([#468](https://togithub.com/sindresorhus/execa/issues/468)) [`2b9c0e1`](https://togithub.com/sindresorhus/execa/commit/2b9c0e1) ### [`v5.1.0`](https://togithub.com/sindresorhus/execa/releases/tag/v5.1.0) [Compare Source](https://togithub.com/sindresorhus/execa/compare/v5.0.1...v5.1.0) - Add [`.escapedCommand`](https://togithub.com/sindresorhus/execa#escapedcommand) property to the results ([#466](https://togithub.com/sindresorhus/execa/issues/466)) [`712bafc`](https://togithub.com/sindresorhus/execa/commit/712bafc) ### [`v5.0.1`](https://togithub.com/sindresorhus/execa/releases/tag/v5.0.1) [Compare Source](https://togithub.com/sindresorhus/execa/compare/v5.0.0...v5.0.1) - Fix `timeout` option validation ([#463](https://togithub.com/sindresorhus/execa/issues/463)) [`427c5c2`](https://togithub.com/sindresorhus/execa/commit/427c5c2)Configuration
📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
This PR has been generated by Mend Renovate. View repository job log here.