Esc-get-cmd-stdout-array-promise NPM

esc-get-cmd-stdout-array-promise

Runs the provided command and returns a promise that resolves with array of lines of stdout.

Install

npm install esc-get-cmd-stdout-array-promise

Use

I ran these commands in a terminal

/$ mkdir /tmp/foo
/$ cd /tmp/foo
/tmp/foo$ touch file1.txt file2.zip file3.mp3
/tmp/foo$ mkdir dir1 dir2

import getCmdStdoutAP from 'esc-get-cmd-stdout-array-promise';
import colors from 'esc-colors'; // optional

( async () => {
  const linesA = await getCmdStdoutAP('ls', { cwd:'/tmp/foo' }, colors);
  console.log('linesA', linesA);
})();

  const linesA = await getCmdStdoutAP('ls -la', { cwd:'/tmp/foo' }, colors);
  console.log('linesA', linesA);

Obviously ls isn't the best use for this module, but it's an example that anyone would be familiar with.

onError options

When the command that you run fails

(default) - Promise rejects
onError:'exit' - Exit the process
onError:'empty' - You receive []
onError:[] - You receive []
onError:['some','failsafe','output'] - You receive ['some','failsafe','output']

/tmp/foo$ printf 'APPLE\nORANGE\n' > fruit-selection.txt

  const linesA = await getCmdStdoutAP('cat fruit-selection.txt', { cwd:'/tmp/foo', onError:['GRAPE'] }, colors);
  console.log('linesA', linesA);

/tmp/foo$ rm fruit-selection.txt

Inspiration

Initially I liked zx but found it a nightmare to debug scripts run with it when something went wrong.

So I started using zx as a dependency and running my scripts with Node.JS.

Then I realized the only thing I like about zx is how you can run stuff, and I was even wrapping zx to turn stdout into an array, etc. So I just made something better (for me).

This is a 1.2KiB alternative to the zx's 831KiB. I sleep better at night.