tiny-exec
TypeScript icon, indicating that this package has built-in type declarations

1.0.0 • Public • Published

Tiny Exec

A tiny wrapper around "spawn" for executing a command efficiently and conveniently.

It supports all options that child_process.spawn itself supports.

Install

npm install --save tiny-exec

Usage

import exec from 'tiny-exec';

// Execute a command successfully, directly

const result = await exec ( 'echo', ['example'] );

result.ok; // => true, because the exit code is 0
result.code; // => 0
result.stderr; // => <Buffer >
result.stdout; // => <Buffer 65 78 61 6d 70 6c 65 0a>
result.stdout.toString (); // => 'example\n'

// Execute a command successfully, going through the shell

const result = await exec ( 'echo "example"', { shell: true } );

result.ok; // => true, because the exit code is 0
result.code; // => 0
result.stderr; // => <Buffer >
result.stdout; // => <Buffer 65 78 61 6d 70 6c 65 0a>
result.stdout.toString (); // => 'example\n'

// Execute a command successfully, but with a non-zero exit code

const result = await exec ( 'node', ['-e', 'process.exit(2)'] );

result.ok; // => false, because the exit code is not 0
result.code; // => 2
result.stderr; // => <Buffer >
result.stdout; // => <Buffer >

// Execute a command that throws

await exec ( 'unknowncmd' ); // => throws: Error ( 'spawn unknowncmd ENOENT' )

License

MIT © Fabio Spampinato

Dependencies (0)

    Dev Dependencies (4)

    Package Sidebar

    Install

    npm i tiny-exec

    Weekly Downloads

    28

    Version

    1.0.0

    License

    none

    Unpacked Size

    9.56 kB

    Total Files

    15

    Last publish

    Collaborators

    • fabiospampinato