cmd.js

import childProcess from 'node:child_process';

/**
 * Execute a shell command.
 * @function module:cmd.run_
 * @param {string} cmd - Command line to execute
 * @param {object} options
 * @returns {Promise.<Object>}
 */
export const run_ = (cmd, options) =>
    new Promise((resolve, reject) =>
        childProcess.exec(cmd, { windowsHide: true, ...options }, (error, stdout, stderr) => {
            if (error) {
                return reject(error);
            }

            return resolve({ stdout, stderr });
        })
    );

/**
 * Execute a shell command and lively output
 * @function module:cmd.runLive_
 * @param {string} cmd - Command line to execute
 * @param {Array} [args] - Arguments list *
 * @param {*} onStdOut -
 * @param {*} onStdErr
 * @param {*} options
 * @returns {Promise.<Object>}
 */
export const runLive_ = (cmd, args, onStdOut, onStdErr, options) => {
    if (typeof args === 'string') {
        args = args.split(' ');
    }

    return new Promise((resolve, reject) => {
        let ps = childProcess.spawn(cmd, args, {
            windowsHide: true,
            ...options,
        });
        let e;

        onStdOut ??= (s) => process.stdout.write(s);
        onStdErr ??= (s) => process.stderr.write(s);

        ps.stdout.on('data', onStdOut);
        ps.stderr.on('data', onStdErr);

        ps.on('close', (code) => (e ? reject(e) : resolve(code)));
        ps.on('error', (error) => {
            e = error;
        });
    });
};

/**
 * Execute a shell command synchronously
 * @function module:cmd.runSync
 * @param {string} cmd - Command line to execute
 * @returns {string}
 */
export const runSync = (cmd, options) => childProcess.execSync(cmd, { windowsHide: true, ...options }).toString();