run-scripts-util/dist/run-scripts.js

Organize npm package.json scripts into groups of easy to manage commands (CLI tool designed for use in npm package.json scripts)

//! run-scripts-util v1.3.1 ~~ https://github.com/center-key/run-scripts-util ~~ MIT License

import { spawn, spawnSync } from 'node:child_process';
import chalk from 'chalk';
import fs from 'fs';
import log from 'fancy-log';
const arrow = chalk.gray.bold('→');
const createLogger = (settings) => (...args) => !settings.quiet && log(chalk.gray('run-scripts'), ...args);
const runScripts = {
    exec(group, options) {
        const defaults = {
            continueOnError: false,
            only: null,
            quiet: false,
            verbose: false,
        };
        const settings = { ...defaults, ...options };
        const pkg = JSON.parse(fs.readFileSync('package.json', 'utf-8'));
        const commands = pkg.runScriptsConfig?.[group] ?? [pkg.scripts?.[group]];
        const logger = createLogger(settings);
        if (!Array.isArray(commands) || commands.some(command => typeof command !== 'string'))
            throw new Error('[run-scripts-util] Cannot find commands: ' + group);
        const execCommand = (step, command) => {
            const startTime = Date.now();
            if (!settings.quiet)
                console.log();
            const logItems = [chalk.white(group)];
            if (settings.verbose)
                logItems.push(chalk.yellow(step), arrow);
            logger(...logItems, chalk.cyanBright(command));
            const task = spawnSync(command, { shell: true, stdio: 'inherit' });
            const errorMessage = () => `Task: ${group} (step ${step}), Status: ${task.status}`;
            if (task.status !== 0 && settings.continueOnError)
                logger(chalk.red('ERROR'), chalk.white('-->'), errorMessage());
            if (task.status !== 0 && !settings.continueOnError)
                throw new Error('[run-scripts-util] ' + errorMessage() + '\nCommand: ' + command);
            logger(...logItems, chalk.green('done'), chalk.white(`(${Date.now() - startTime}ms)`));
        };
        const skip = (step, command) => {
            const active = settings.only === null || step === settings.only;
            const commentedOut = command.startsWith('//');
            if (commentedOut)
                logger(chalk.yellow('skipping:'), command);
            return !active || commentedOut;
        };
        const processCommand = (command, index) => !skip(index + 1, command) && execCommand(index + 1, command);
        commands.forEach(processCommand);
    },
    execParallel(group, options) {
        const defaults = {
            continueOnError: false,
            only: null,
            quiet: false,
            verbose: false,
        };
        const settings = { ...defaults, ...options };
        const pkg = JSON.parse(fs.readFileSync('package.json', 'utf-8'));
        const commands = pkg.runScriptsConfig?.[group] ?? [pkg.scripts?.[group]];
        if (!Array.isArray(commands) || commands.some(command => typeof command !== 'string'))
            throw new Error('[run-scripts-util] Cannot find commands: ' + group);
        const logger = createLogger(settings);
        const active = (step) => settings.only === null || step === settings.only;
        const process = (step, command) => new Promise((resolve) => {
            const start = Date.now();
            const task = spawn(command, { shell: true, stdio: 'inherit' });
            const pid = task.pid ?? null;
            const logItems = [chalk.white(group), chalk.yellow(step)];
            if (settings.verbose)
                logItems.push(chalk.magenta('pid: ' + String(pid)), arrow);
            logger(...logItems, chalk.cyanBright(command));
            const processInfo = (code, ms) => ({ group, step, pid, start, code, ms });
            task.on('close', (code) => resolve(processInfo(code, Date.now() - start)));
            task.on('close', (code) => logger(...logItems, chalk.green('done'), chalk.white(`(code: ${code}, ${Date.now() - start}ms)`)));
        });
        const createProcess = (command, index) => active(index + 1) ? process(index + 1, command) : Promise.resolve(null);
        logger(chalk.white(group), chalk.blue('--parallel'));
        return Promise.all(commands.map(createProcess));
    },
};
export { runScripts };