concurrently 7.0.0 → 7.2.1

package/README.md

@@ -1,6 +1,6 @@
 # Concurrently
 
-[![Build Status](https://github.com/open-cli-tools/concurrently/workflows/Tests/badge.svg)](https://github.com/open-cli-tools/concurrently/actions?workflow=Tests) 
+[![Build Status](https://github.com/open-cli-tools/concurrently/workflows/Tests/badge.svg)](https://github.com/open-cli-tools/concurrently/actions?workflow=Tests)
 [![Coverage Status](https://coveralls.io/repos/github/open-cli-tools/concurrently/badge.svg?branch=master)](https://coveralls.io/github/open-cli-tools/concurrently?branch=master)
 
 [![NPM Badge](https://nodei.co/npm/concurrently.png?downloads=true)](https://www.npmjs.com/package/concurrently)
@@ -109,38 +109,68 @@ concurrently -n w: npm:watch-*
 concurrently -n w:js,w:css,w:node "npm run watch-js" "npm run watch-css" "npm run watch-node"
 ```
 
+Exclusion is also supported. Given the following scripts in package.json:
+```javascript
+{
+    // ...
+    "scripts": {
+      "lint:js": "...",
+      "lint:ts": "...",
+      "lint:fix:js": "...",
+      "lint:fix:ts": "...",
+      // ...
+    }
+    // ...
+}
+```
+```bash
+# Running only lint:js and lint:ts
+#   with lint:fix:js and lint:fix:ts excluded
+concurrently "npm:lint:*(!fix)"
+```
+
 Good frontend one-liner example [here](https://github.com/kimmobrunfeldt/dont-copy-paste-this-frontend-template/blob/5cd2bde719654941bdfc0a42c6f1b8e69ae79980/package.json#L9).
 
 Help:
 
 ```
-
 concurrently [options] <command ...>
 
 General
-  -m, --max-processes   How many processes should run at once.
-                        New processes only spawn after all restart tries of a
-                        process.                                        [number]
-  -n, --names           List of custom names to be used in prefix template.
-                        Example names: "main,browser,server"            [string]
-      --name-separator  The character to split <names> on. Example usage:
-                        concurrently -n "styles|scripts|server" --name-separator
-                        "|"                                       [default: ","]
-  -r, --raw             Output only raw output of processes, disables
-                        prettifying and concurrently coloring.         [boolean]
-  -s, --success         Return exit code of zero or one based on the success or
-                        failure of the "first" child to terminate, the "last
-                        child", or succeed only if "all" child processes
-                        succeed.
-                              [choices: "first", "last", "all"] [default: "all"]
-      --no-color        Disables colors from logging                   [boolean]
-      --hide            Comma-separated list of processes to hide the output.
-                        The processes can be identified by their name or index.
-                                                          [string] [default: ""]
-  -g, --group           Order the output as if the commands were run
-                        sequentially.                                  [boolean]
-      --timings         Show timing information for all processes
+  -m, --max-processes          How many processes should run at once.
+                               New processes only spawn after all restart tries
+                               of a process.                            [number]
+  -n, --names                  List of custom names to be used in prefix
+                               template.
+                               Example names: "main,browser,server"     [string]
+      --name-separator         The character to split <names> on. Example usage:
+                               concurrently -n "styles|scripts|server"
+                               --name-separator "|"               [default: ","]
+  -s, --success                Which command(s) must exit with code 0 in order
+                               for concurrently exit with code 0 too. Options
+                               are:
+                               - "first" for the first command to exit;
+                               - "last" for the last command to exit;
+                               - "all" for all commands;
+                               - "command-{name}"/"command-{index}" for the
+                               commands with that name or index;
+                               - "!command-{name}"/"!command-{index}" for all
+                               commands but the ones with that name or index.
+                                                                [default: "all"]
+  -r, --raw                    Output only raw output of processes, disables
+                               prettifying and concurrently coloring.  [boolean]
+      --no-color               Disables colors from logging            [boolean]
+      --hide                   Comma-separated list of processes to hide the
+                               output.
+                               The processes can be identified by their name or
+                               index.                     [string] [default: ""]
+  -g, --group                  Order the output as if the commands were run
+                               sequentially.                           [boolean]
+      --timings                Show timing information for all processes.
                                                       [boolean] [default: false]
+  -P, --passthrough-arguments  Passthrough additional arguments to commands
+                               (accessible via placeholders) instead of treating
+                               them as commands.      [boolean] [default: false]
 
 Prefix styling
   -p, --prefix            Prefix used in logging for each process.
@@ -177,9 +207,9 @@ Input handling
                               process.                              [default: 0]
 
 Killing other processes
-  -k, --kill-others          kill other processes if one exits or dies [boolean]
-      --kill-others-on-fail  kill other processes if one exits with non zero
-                             status code                               [boolean]
+  -k, --kill-others          Kill other processes if one exits or dies.[boolean]
+      --kill-others-on-fail  Kill other processes if one exits with non zero
+                             status code.                              [boolean]
 
 Restarting
       --restart-tries  How many times a process that died should restart.
@@ -192,6 +222,7 @@ Options:
   -h, --help         Show help                                         [boolean]
   -v, -V, --version  Show version number                               [boolean]
 
+
 Examples:
 
  - Output nothing more than stdout+stderr of child processes
@@ -213,7 +244,8 @@ Examples:
 
  - Configuring via environment variables with CONCURRENTLY_ prefix
 
-     $ CONCURRENTLY_RAW=true CONCURRENTLY_KILL_OTHERS=true concurrently "echo hello" "echo world"
+     $ CONCURRENTLY_RAW=true CONCURRENTLY_KILL_OTHERS=true concurrently "echo
+     hello" "echo world"
 
  - Send input to default
 
@@ -238,6 +270,23 @@ Examples:
 
      $ concurrently "npm:watch-*"
 
+ - Exclude patterns so that between "lint:js" and "lint:fix:js", only "lint:js"
+ is ran
+
+     $ concurrently "npm:*(!fix)"
+
+ - Passthrough some additional arguments via '{<number>}' placeholder
+
+     $ concurrently -P "echo {1}" -- foo
+
+ - Passthrough all additional arguments via '{@}' placeholder
+
+     $ concurrently -P "npm:dev-* -- {@}" -- --watch --noEmit
+
+ - Passthrough all additional arguments combined via '{*}' placeholder
+
+     $ concurrently -P "npm:dev-* -- {*}" -- --watch --noEmit
+
 For more details, visit https://github.com/open-cli-tools/concurrently
 ```
 
@@ -279,8 +328,9 @@ concurrently can be used programmatically by using the API documented below:
     - `restartDelay`: how many milliseconds to wait between process restarts. Default: `0`.
     - `timestampFormat`: a [date-fns format](https://date-fns.org/v2.0.1/docs/format)
     to use when prefixing with `time`. Default: `yyyy-MM-dd HH:mm:ss.ZZZ`
+    - `additionalArguments`: list of additional arguments passed that will get replaced in each command. If not defined, no argument replacing will happen.
 
-> **Returns:** an object in the shape `{ commands, result }`.
+> **Returns:** an object in the shape `{ result, commands }`.
 > - `result`: a `Promise` that resolves if the run was successful (according to `successCondition` option),
 >   or rejects, containing an array of [`CloseEvent`](#CloseEvent), in the order that the commands terminated.
 > - `commands`: an array of all spawned [`Command`s](#Command).
@@ -289,7 +339,7 @@ Example:
 
 ```js
 const concurrently = require('concurrently');
-concurrently([
+const { result } = concurrently([
     'npm:watch-*',
     { command: 'nodemon', name: 'server' },
     { command: 'deploy', name: 'deploy', env: { PUBLIC_KEY: '...' } },
@@ -299,11 +349,12 @@ concurrently([
     killOthers: ['failure', 'success'],
     restartTries: 3,
     cwd: path.resolve(__dirname, 'scripts'),
-}).then(success, failure);
+});
+result.then(success, failure);
 ```
 
 ### `Command`
-An object that contains all information about a spawned command, and ways to interact with it.  
+An object that contains all information about a spawned command, and ways to interact with it.<br>
 It has the following properties:
 
 - `index`: the index of the command among all commands spawned.
@@ -321,11 +372,11 @@ It has the following properties:
 - `timer`: an RxJS observable to the command's timing events (e.g. starting, stopping).
 - `close`: an RxJS observable to the command's close events.
   See [`CloseEvent`](#CloseEvent) for more information.
-- `start()`: starts the command, setting up all 
+- `start()`: starts the command, setting up all
 - `kill([signal])`: kills the command, optionally specifying a signal (e.g. `SIGTERM`, `SIGKILL`, etc).
 
 ### `CloseEvent`
-An object with information about a command's closing event.  
+An object with information about a command's closing event.<br>
 It contains the following properties:
 
 - `command`: a stripped down version of [`Command`](#command), including only `name`, `command`, `env` and `cwd` properties.

package/dist/bin/concurrently.js

@@ -24,10 +24,19 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const yargs_1 = __importDefault(require("yargs"));
+const helpers_1 = require("yargs/helpers");
 const defaults = __importStar(require("../src/defaults"));
 const index_1 = __importDefault(require("../src/index"));
 const epilogue_1 = require("./epilogue");
-const args = yargs_1.default
+// Clean-up arguments (yargs expects only the arguments after the program name)
+const cleanArgs = (0, helpers_1.hideBin)(process.argv);
+// Find argument separator (double dash)
+const argsSepIdx = cleanArgs.findIndex((arg) => arg === '--');
+// Arguments before separator
+const argsBeforeSep = argsSepIdx >= 0 ? cleanArgs.slice(0, argsSepIdx) : cleanArgs;
+// Arguments after separator
+const argsAfterSep = argsSepIdx >= 0 ? cleanArgs.slice(argsSepIdx + 1) : [];
+const args = (0, yargs_1.default)(argsBeforeSep)
     .usage('$0 [options] <command ...>')
     .help('h')
     .alias('h', 'help')
@@ -42,13 +51,13 @@ const args = yargs_1.default
         alias: 'm',
         describe: 'How many processes should run at once.\n' +
             'New processes only spawn after all restart tries of a process.',
-        type: 'number'
+        type: 'number',
     },
     'names': {
         alias: 'n',
         describe: 'List of custom names to be used in prefix template.\n' +
             'Example names: "main,browser,server"',
-        type: 'string'
+        type: 'string',
     },
     'name-separator': {
         describe: 'The character to split <names> on. Example usage:\n' +
@@ -57,49 +66,61 @@ const args = yargs_1.default
     },
     'success': {
         alias: 's',
-        describe: 'Return exit code of zero or one based on the success or failure ' +
-            'of the "first" child to terminate, the "last child", or succeed ' +
-            'only if "all" child processes succeed.',
-        choices: ['first', 'last', 'all'],
-        default: defaults.success
+        describe: 'Which command(s) must exit with code 0 in order for concurrently exit with ' +
+            'code 0 too. Options are:\n' +
+            '- "first" for the first command to exit;\n' +
+            '- "last" for the last command to exit;\n' +
+            '- "all" for all commands;\n' +
+            // Note: not a typo. Multiple commands can have the same name.
+            '- "command-{name}"/"command-{index}" for the commands with that name or index;\n' +
+            '- "!command-{name}"/"!command-{index}" for all commands but the ones with that ' +
+            'name or index.\n',
+        default: defaults.success,
     },
     'raw': {
         alias: 'r',
         describe: 'Output only raw output of processes, disables prettifying ' +
             'and concurrently coloring.',
-        type: 'boolean'
+        type: 'boolean',
     },
     // This one is provided for free. Chalk reads this itself and removes colours.
     // https://www.npmjs.com/package/chalk#chalksupportscolor
     'no-color': {
         describe: 'Disables colors from logging',
-        type: 'boolean'
+        type: 'boolean',
     },
     'hide': {
         describe: 'Comma-separated list of processes to hide the output.\n' +
             'The processes can be identified by their name or index.',
         default: defaults.hide,
-        type: 'string'
+        type: 'string',
     },
     'group': {
         alias: 'g',
         describe: 'Order the output as if the commands were run sequentially.',
-        type: 'boolean'
+        type: 'boolean',
     },
     'timings': {
-        describe: 'Show timing information for all processes',
+        describe: 'Show timing information for all processes.',
+        type: 'boolean',
+        default: defaults.timings,
+    },
+    'passthrough-arguments': {
+        alias: 'P',
+        describe: 'Passthrough additional arguments to commands (accessible via placeholders) ' +
+            'instead of treating them as commands.',
         type: 'boolean',
-        default: defaults.timings
+        default: defaults.passthroughArguments,
     },
     // Kill others
     'kill-others': {
         alias: 'k',
-        describe: 'kill other processes if one exits or dies',
-        type: 'boolean'
+        describe: 'Kill other processes if one exits or dies.',
+        type: 'boolean',
     },
     'kill-others-on-fail': {
-        describe: 'kill other processes if one exits with non zero status code',
-        type: 'boolean'
+        describe: 'Kill other processes if one exits with non zero status code.',
+        type: 'boolean',
     },
     // Prefix
     'prefix': {
@@ -108,7 +129,7 @@ const args = yargs_1.default
             'Possible values: index, pid, time, command, name, none, or a template. ' +
             'Example template: "{time}-{pid}"',
         defaultDescription: 'index or name (when --names is set)',
-        type: 'string'
+        type: 'string',
     },
     'prefix-colors': {
         alias: 'c',
@@ -120,74 +141,78 @@ const args = yargs_1.default
             '- Available background colors: bgBlack, bgRed, bgGreen, bgYellow, bgBlue, bgMagenta, bgCyan, bgWhite\n' +
             'See https://www.npmjs.com/package/chalk for more information.',
         default: defaults.prefixColors,
-        type: 'string'
+        type: 'string',
     },
     'prefix-length': {
         alias: 'l',
         describe: 'Limit how many characters of the command is displayed in prefix. ' +
             'The option can be used to shorten the prefix when it is set to "command"',
         default: defaults.prefixLength,
-        type: 'number'
+        type: 'number',
     },
     'timestamp-format': {
         alias: 't',
         describe: 'Specify the timestamp in moment/date-fns format.',
         default: defaults.timestampFormat,
-        type: 'string'
+        type: 'string',
     },
     // Restarting
     'restart-tries': {
         describe: 'How many times a process that died should restart.\n' +
             'Negative numbers will make the process restart forever.',
         default: defaults.restartTries,
-        type: 'number'
+        type: 'number',
     },
     'restart-after': {
         describe: 'Delay time to respawn the process, in milliseconds.',
         default: defaults.restartDelay,
-        type: 'number'
+        type: 'number',
     },
     // Input
     'handle-input': {
         alias: 'i',
         describe: 'Whether input should be forwarded to the child processes. ' +
             'See examples for more information.',
-        type: 'boolean'
+        type: 'boolean',
     },
     'default-input-target': {
         default: defaults.defaultInputTarget,
         describe: 'Identifier for child process to which input on stdin ' +
             'should be sent if not specified at start of input.\n' +
-            'Can be either the index or the name of the process.'
-    }
+            'Can be either the index or the name of the process.',
+    },
 })
-    .group(['m', 'n', 'name-separator', 'raw', 's', 'no-color', 'hide', 'group', 'timings'], 'General')
+    .group(['m', 'n', 'name-separator', 's', 'r', 'no-color', 'hide', 'g', 'timings', 'P'], 'General')
     .group(['p', 'c', 'l', 't'], 'Prefix styling')
     .group(['i', 'default-input-target'], 'Input handling')
     .group(['k', 'kill-others-on-fail'], 'Killing other processes')
     .group(['restart-tries', 'restart-after'], 'Restarting')
     .epilogue(epilogue_1.epilogue)
-    .argv;
-const names = (args.names || '').split(args['name-separator']);
-(0, index_1.default)(args._.map((command, index) => ({
+    .parseSync();
+// Get names of commands by the specified separator
+const names = (args.names || '').split(args.nameSeparator);
+// If "passthrough-arguments" is disabled, treat additional arguments as commands
+const commands = args.passthroughArguments ? args._ : [...args._, ...argsAfterSep];
+(0, index_1.default)(commands.map((command, index) => ({
     command: String(command),
-    name: names[index]
+    name: names[index],
 })), {
-    handleInput: args['handle-input'],
-    defaultInputTarget: args['default-input-target'],
+    handleInput: args.handleInput,
+    defaultInputTarget: args.defaultInputTarget,
     killOthers: args.killOthers
         ? ['success', 'failure']
         : (args.killOthersOnFail ? ['failure'] : []),
-    maxProcesses: args['max-processes'],
+    maxProcesses: args.maxProcesses,
     raw: args.raw,
     hide: args.hide.split(','),
     group: args.group,
     prefix: args.prefix,
-    prefixColors: args['prefix-colors'].split(','),
-    prefixLength: args['prefix-length'],
-    restartDelay: args['restart-after'],
-    restartTries: args['restart-tries'],
+    prefixColors: args.prefixColors.split(','),
+    prefixLength: args.prefixLength,
+    restartDelay: args.restartAfter,
+    restartTries: args.restartTries,
     successCondition: args.success,
-    timestampFormat: args['timestamp-format'],
-    timings: args.timings
+    timestampFormat: args.timestampFormat,
+    timings: args.timings,
+    additionalArguments: args.passthroughArguments ? argsAfterSep : undefined,
 }).result.then(() => process.exit(0), () => process.exit(1));

package/dist/bin/epilogue.js

@@ -6,11 +6,11 @@ exports.epilogue = void 0;
 const examples = [
     {
         description: 'Output nothing more than stdout+stderr of child processes',
-        example: '$ $0 --raw "npm run watch-less" "npm run watch-js"'
+        example: '$ $0 --raw "npm run watch-less" "npm run watch-js"',
     },
     {
         description: 'Normal output but without colors e.g. when logging to file',
-        example: '$ $0 --no-color "grunt watch" "http-server" > log'
+        example: '$ $0 --no-color "grunt watch" "http-server" > log',
     },
     {
         description: 'Custom prefix',
@@ -28,21 +28,21 @@ const examples = [
         description: 'Send input to default',
         example: [
             '$ $0 --handle-input "nodemon" "npm run watch-js"',
-            'rs  # Sends rs command to nodemon process'
+            'rs  # Sends rs command to nodemon process',
         ].join('\n'),
     },
     {
         description: 'Send input to specific child identified by index',
         example: [
             '$ $0 --handle-input "npm run watch-js" nodemon',
-            '1:rs'
+            '1:rs',
         ].join('\n'),
     },
     {
         description: 'Send input to specific child identified by name',
         example: [
             '$ $0 --handle-input -n js,srv "npm run watch-js" nodemon',
-            'srv:rs'
+            'srv:rs',
         ].join('\n'),
     },
     {
@@ -52,7 +52,23 @@ const examples = [
     {
         description: 'Shortened NPM run command with wildcard (make sure to wrap it in quotes!)',
         example: '$ $0 "npm:watch-*"',
-    }
+    },
+    {
+        description: 'Exclude patterns so that between "lint:js" and "lint:fix:js", only "lint:js" is ran',
+        example: '$ $0 "npm:*(!fix)"',
+    },
+    {
+        description: 'Passthrough some additional arguments via \'{<number>}\' placeholder',
+        example: '$ $0 -P "echo {1}" -- foo',
+    },
+    {
+        description: 'Passthrough all additional arguments via \'{@}\' placeholder',
+        example: '$ $0 -P "npm:dev-* -- {@}" -- --watch --noEmit',
+    },
+    {
+        description: 'Passthrough all additional arguments combined via \'{*}\' placeholder',
+        example: '$ $0 -P "npm:dev-* -- {*}" -- --watch --noEmit',
+    },
 ];
 exports.epilogue = `
 Examples:

package/dist/src/command-parser/expand-arguments.d.ts

@@ -0,0 +1,12 @@
+import { CommandInfo } from '../command';
+import { CommandParser } from './command-parser';
+/**
+ * Replace placeholders with additional arguments.
+ */
+export declare class ExpandArguments implements CommandParser {
+    private readonly additionalArguments;
+    constructor(additionalArguments: string[]);
+    parse(commandInfo: CommandInfo): CommandInfo & {
+        command: string;
+    };
+}

package/dist/src/command-parser/expand-arguments.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExpandArguments = void 0;
+const shell_quote_1 = require("shell-quote");
+/**
+ * Replace placeholders with additional arguments.
+ */
+class ExpandArguments {
+    constructor(additionalArguments) {
+        this.additionalArguments = additionalArguments;
+    }
+    parse(commandInfo) {
+        const command = commandInfo.command.replace(/\\?\{([@\*]|[1-9][0-9]*)\}/g, (match, placeholderTarget) => {
+            // Don't replace the placeholder if it is escaped by a backslash.
+            if (match.startsWith('\\')) {
+                return match.substring(1);
+            }
+            // Replace numeric placeholder if value exists in additional arguments.
+            if (!isNaN(placeholderTarget) &&
+                placeholderTarget <= this.additionalArguments.length) {
+                return (0, shell_quote_1.quote)([this.additionalArguments[placeholderTarget - 1]]);
+            }
+            // Replace all arguments placeholder.
+            if (placeholderTarget === '@') {
+                return (0, shell_quote_1.quote)(this.additionalArguments);
+            }
+            // Replace combined arguments placeholder.
+            if (placeholderTarget === '*') {
+                return (0, shell_quote_1.quote)([this.additionalArguments.join(' ')]);
+            }
+            // Replace placeholder with empty string
+            // if value doesn't exist in additional arguments.
+            return '';
+        });
+        return Object.assign({}, commandInfo, {
+            command,
+        });
+    }
+}
+exports.ExpandArguments = ExpandArguments;

package/dist/src/command-parser/expand-npm-shortcut.js

@@ -12,7 +12,7 @@ class ExpandNpmShortcut {
         }
         return Object.assign({}, commandInfo, {
             name: commandInfo.name || cmdName,
-            command: `${npmCmd} run ${cmdName}${args}`
+            command: `${npmCmd} run ${cmdName}${args}`,
         });
     }
 }

package/dist/src/command-parser/expand-npm-wildcard.js

@@ -22,6 +22,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ExpandNpmWildcard = void 0;
 const fs = __importStar(require("fs"));
 const _ = __importStar(require("lodash"));
+const OMISSION = /\(!([^\)]+)\)/;
 /**
  * Finds wildcards in npm/yarn/pnpm run commands and replaces them with all matching scripts in the
  * `package.json` file of the current directory.
@@ -50,13 +51,21 @@ class ExpandNpmWildcard {
         if (!this.scripts) {
             this.scripts = Object.keys(this.readPackage().scripts || {});
         }
-        const preWildcard = _.escapeRegExp(cmdName.substr(0, wildcardPosition));
-        const postWildcard = _.escapeRegExp(cmdName.substr(wildcardPosition + 1));
+        const omissionRegex = cmdName.match(OMISSION);
+        const cmdNameSansOmission = cmdName.replace(OMISSION, '');
+        const preWildcard = _.escapeRegExp(cmdNameSansOmission.substr(0, wildcardPosition));
+        const postWildcard = _.escapeRegExp(cmdNameSansOmission.substr(wildcardPosition + 1));
         const wildcardRegex = new RegExp(`^${preWildcard}(.*?)${postWildcard}$`);
         const currentName = commandInfo.name || '';
         return this.scripts
             .map(script => {
             const match = script.match(wildcardRegex);
+            if (omissionRegex) {
+                const toOmit = script.match(new RegExp(omissionRegex[1]));
+                if (toOmit) {
+                    return;
+                }
+            }
             if (match) {
                 return Object.assign({}, commandInfo, {
                     command: `${npmCmd} run ${script}${args}`,

package/dist/src/command-parser/strip-quotes.js

@@ -9,7 +9,7 @@ class StripQuotes {
         let { command } = commandInfo;
         // Removes the quotes surrounding a command.
         if (/^"(.+?)"$/.test(command) || /^'(.+?)'$/.test(command)) {
-            command = command.substr(1, command.length - 2);
+            command = command.substring(1, command.length - 1);
         }
         return Object.assign({}, commandInfo, { command });
     }

package/dist/src/command.d.ts

@@ -23,6 +23,9 @@ export interface CommandInfo {
      * The current working directory of the process when spawned.
      */
     cwd?: string;
+    /**
+     * Color to use on prefix of command.
+     */
     prefixColor?: string;
 }
 export interface CloseEvent {

package/dist/src/command.js

@@ -74,7 +74,7 @@ class Command {
                     startDate,
                     endDate,
                     durationSeconds: durationSeconds + (durationNanoSeconds / 1e9),
-                }
+                },
             });
         });
         child.stdout && pipeTo(Rx.fromEvent(child.stdout, 'data'), this.stdout);

package/dist/src/completion-listener.d.ts

@@ -6,8 +6,10 @@ import { CloseEvent, Command } from './command';
  * - `first`: only the first specified command;
  * - `last`: only the last specified command;
  * - `all`: all commands.
+ * - `command-{name|index}`: only the commands with the specified names or index.
+ * - `!command-{name|index}`: all commands but the ones with the specified names or index.
  */
-export declare type SuccessCondition = 'first' | 'last' | 'all';
+export declare type SuccessCondition = 'first' | 'last' | 'all' | `command-${string | number}` | `!command-${string | number}`;
 /**
  * Provides logic to determine whether lists of commands ran successfully.
 */

package/dist/src/completion-listener.js

@@ -30,17 +30,32 @@ class CompletionListener {
         this.successCondition = successCondition;
         this.scheduler = scheduler;
     }
-    isSuccess(exitCodes) {
-        switch (this.successCondition) {
-            /* eslint-disable indent */
-            case 'first':
-                return exitCodes[0] === 0;
-            case 'last':
-                return exitCodes[exitCodes.length - 1] === 0;
-            default:
-                return exitCodes.every(exitCode => exitCode === 0);
-            /* eslint-enable indent */
+    isSuccess(events) {
+        if (this.successCondition === 'first') {
+            return events[0].exitCode === 0;
         }
+        else if (this.successCondition === 'last') {
+            return events[events.length - 1].exitCode === 0;
+        }
+        const commandSyntaxMatch = this.successCondition.match(/^!?command-(.+)$/);
+        if (commandSyntaxMatch == null) {
+            // If not a `command-` syntax, then it's an 'all' condition or it's treated as such.
+            return events.every(({ exitCode }) => exitCode === 0);
+        }
+        // Check `command-` syntax condition.
+        // Note that a command's `name` is not necessarily unique,
+        // in which case all of them must meet the success condition.
+        const nameOrIndex = commandSyntaxMatch[1];
+        const targetCommandsEvents = events.filter(({ command, index }) => (command.name === nameOrIndex
+            || index === Number(nameOrIndex)));
+        if (this.successCondition.startsWith('!')) {
+            // All commands except the specified ones must exit succesfully
+            return events.every((event) => (targetCommandsEvents.includes(event)
+                || event.exitCode === 0));
+        }
+        // Only the specified commands must exit succesfully
+        return targetCommandsEvents.length > 0
+            && targetCommandsEvents.every(event => event.exitCode === 0);
     }
     /**
      * Given a list of commands, wait for all of them to exit and then evaluate their exit codes.
@@ -50,7 +65,7 @@ class CompletionListener {
     listen(commands) {
         const closeStreams = commands.map(command => command.close);
         return Rx.merge(...closeStreams)
-            .pipe((0, operators_1.bufferCount)(closeStreams.length), (0, operators_1.switchMap)(exitInfos => this.isSuccess(exitInfos.map(({ exitCode }) => exitCode))
+            .pipe((0, operators_1.bufferCount)(closeStreams.length), (0, operators_1.switchMap)(exitInfos => this.isSuccess(exitInfos)
             ? Rx.of(exitInfos, this.scheduler)
             : Rx.throwError(exitInfos, this.scheduler)), (0, operators_1.take)(1))
             .toPromise();

package/dist/src/concurrently.d.ts

@@ -29,7 +29,13 @@ export declare type ConcurrentlyOptions = {
      * Which stream should the commands output be written to.
      */
     outputStream?: Writable;
+    /**
+     * Whether the output should be ordered as if the commands were run sequentially.
+     */
     group?: boolean;
+    /**
+     * Comma-separated list of chalk colors to use on prefixes.
+     */
     prefixColors?: string[];
     /**
      * Maximum number of commands to run at once.
@@ -67,6 +73,13 @@ export declare type ConcurrentlyOptions = {
      * Defaults to the `tree-kill` module.
      */
     kill: KillProcess;
+    /**
+     * List of additional arguments passed that will get replaced in each command.
+     * If not defined, no argument replacing will happen.
+     *
+     * @see ExpandArguments
+     */
+    additionalArguments?: string[];
 };
 /**
  * Core concurrently functionality -- spawns the given commands concurrently and

package/dist/src/concurrently.js

@@ -9,6 +9,7 @@ const lodash_1 = __importDefault(require("lodash"));
 const spawn_command_1 = __importDefault(require("spawn-command"));
 const tree_kill_1 = __importDefault(require("tree-kill"));
 const command_1 = require("./command");
+const expand_arguments_1 = require("./command-parser/expand-arguments");
 const expand_npm_shortcut_1 = require("./command-parser/expand-npm-shortcut");
 const expand_npm_wildcard_1 = require("./command-parser/expand-npm-wildcard");
 const strip_quotes_1 = require("./command-parser/strip-quotes");
@@ -35,8 +36,11 @@ function concurrently(baseCommands, baseOptions) {
     const commandParsers = [
         new strip_quotes_1.StripQuotes(),
         new expand_npm_shortcut_1.ExpandNpmShortcut(),
-        new expand_npm_wildcard_1.ExpandNpmWildcard()
+        new expand_npm_wildcard_1.ExpandNpmWildcard(),
     ];
+    if (options.additionalArguments) {
+        commandParsers.push(new expand_arguments_1.ExpandArguments(options.additionalArguments));
+    }
     let lastColor = '';
     let commands = (0, lodash_1.default)(baseCommands)
         .map(mapToCommandInfo)
@@ -58,7 +62,7 @@ function concurrently(baseCommands, baseOptions) {
         const { commands, onFinish } = controller.handle(prevCommands);
         return {
             commands,
-            onFinishCallbacks: lodash_1.default.concat(onFinishCallbacks, onFinish ? [onFinish] : [])
+            onFinishCallbacks: lodash_1.default.concat(onFinishCallbacks, onFinish ? [onFinish] : []),
         };
     }, { commands, onFinishCallbacks: [] });
     commands = handleResult.commands;

package/dist/src/defaults.d.ts

@@ -1,14 +1,20 @@
 import { SuccessCondition } from './completion-listener';
 export declare const defaultInputTarget = 0;
 /**
- * Whether process.stdin should be forwarded to child processes
+ * Whether process.stdin should be forwarded to child processes.
  */
 export declare const handleInput = false;
 /**
  * How many processes to run at once.
  */
 export declare const maxProcesses = 0;
+/**
+ * Indices and names of commands whose output are not to be logged.
+ */
 export declare const hide = "";
+/**
+ * The character to split <names> on.
+ */
 export declare const nameSeparator = ",";
 /**
  * Which prefix style to use when logging processes output.
@@ -20,12 +26,12 @@ export declare const prefix = "";
  */
 export declare const prefixColors = "reset";
 /**
- * How many bytes we'll show on the command prefix
+ * How many bytes we'll show on the command prefix.
  */
 export declare const prefixLength = 10;
 export declare const raw = false;
 /**
- * Number of attempts of restarting a process, if it exits with non-0 code
+ * Number of attempts of restarting a process, if it exits with non-0 code.
  */
 export declare const restartTries = 0;
 /**
@@ -47,6 +53,10 @@ export declare const timestampFormat = "yyyy-MM-dd HH:mm:ss.SSS";
  */
 export declare const cwd: string | undefined;
 /**
- * Whether to show timing information for processes in console output
+ * Whether to show timing information for processes in console output.
  */
 export declare const timings = false;
+/**
+ * Passthrough additional arguments to commands (accessible via placeholders) instead of treating them as commands.
+ */
+export declare const passthroughArguments = false;

package/dist/src/defaults.js

@@ -3,18 +3,23 @@
 // It's read by the flow controllers, the executable, etc.
 // Refer to tests for the meaning of the different possible values.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.timings = exports.cwd = exports.timestampFormat = exports.success = exports.restartDelay = exports.restartTries = exports.raw = exports.prefixLength = exports.prefixColors = exports.prefix = exports.nameSeparator = exports.hide = exports.maxProcesses = exports.handleInput = exports.defaultInputTarget = void 0;
+exports.passthroughArguments = exports.timings = exports.cwd = exports.timestampFormat = exports.success = exports.restartDelay = exports.restartTries = exports.raw = exports.prefixLength = exports.prefixColors = exports.prefix = exports.nameSeparator = exports.hide = exports.maxProcesses = exports.handleInput = exports.defaultInputTarget = void 0;
 exports.defaultInputTarget = 0;
 /**
- * Whether process.stdin should be forwarded to child processes
+ * Whether process.stdin should be forwarded to child processes.
  */
 exports.handleInput = false;
 /**
  * How many processes to run at once.
  */
 exports.maxProcesses = 0;
-// Indices and names of commands whose output are not to be logged
+/**
+ * Indices and names of commands whose output are not to be logged.
+ */
 exports.hide = '';
+/**
+ * The character to split <names> on.
+ */
 exports.nameSeparator = ',';
 /**
  * Which prefix style to use when logging processes output.
@@ -26,12 +31,12 @@ exports.prefix = '';
  */
 exports.prefixColors = 'reset';
 /**
- * How many bytes we'll show on the command prefix
+ * How many bytes we'll show on the command prefix.
  */
 exports.prefixLength = 10;
 exports.raw = false;
 /**
- * Number of attempts of restarting a process, if it exits with non-0 code
+ * Number of attempts of restarting a process, if it exits with non-0 code.
  */
 exports.restartTries = 0;
 /**
@@ -53,6 +58,10 @@ exports.timestampFormat = 'yyyy-MM-dd HH:mm:ss.SSS';
  */
 exports.cwd = undefined;
 /**
- * Whether to show timing information for processes in console output
+ * Whether to show timing information for processes in console output.
  */
 exports.timings = false;
+/**
+ * Passthrough additional arguments to commands (accessible via placeholders) instead of treating them as commands.
+ */
+exports.passthroughArguments = false;

package/dist/src/flow-control/kill-on-signal.js

@@ -27,9 +27,9 @@ class KillOnSignal {
                 return new Proxy(command, {
                     get(target, prop) {
                         return prop === 'close' ? closeStream : target[prop];
-                    }
+                    },
                 });
-            })
+            }),
         };
     }
 }

package/dist/src/flow-control/restart-process.js

@@ -61,9 +61,9 @@ class RestartProcess {
                 return new Proxy(command, {
                     get(target, prop) {
                         return prop === 'close' ? closeStream : target[prop];
-                    }
+                    },
                 });
-            })
+            }),
         };
     }
 }

package/dist/src/index.d.ts

@@ -63,6 +63,11 @@ export declare type ConcurrentlyOptions = BaseConcurrentlyOptions & {
      * @see LogTimings
      */
     timings?: boolean;
+    /**
+     * List of additional arguments passed that will get replaced in each command.
+     * If not defined, no argument replacing will happen.
+     */
+    additionalArguments?: string[];
 };
 declare const _default: (commands: ConcurrentlyCommandInput[], options?: Partial<ConcurrentlyOptions>) => ConcurrentlyResult;
 export default _default;

package/dist/src/index.js

@@ -57,13 +57,14 @@ exports.default = (commands, options = {}) => {
             }),
             new kill_others_1.KillOthers({
                 logger,
-                conditions: options.killOthers
+                conditions: options.killOthers,
             }),
             new log_timings_1.LogTimings({
                 logger: options.timings ? logger : null,
                 timestampFormat: options.timestampFormat,
-            })
+            }),
         ],
         prefixColors: options.prefixColors || [],
+        additionalArguments: options.additionalArguments,
     });
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "concurrently",
-  "version": "7.0.0",
+  "version": "7.2.1",
   "description": "Run commands concurrently",
   "main": "index.js",
   "types": "dist/src/index.d.ts",
@@ -44,23 +44,26 @@
     "date-fns": "^2.16.1",
     "lodash": "^4.17.21",
     "rxjs": "^6.6.3",
+    "shell-quote": "^1.7.3",
     "spawn-command": "^0.0.2-1",
     "supports-color": "^8.1.0",
     "tree-kill": "^1.2.2",
-    "yargs": "^16.2.0"
+    "yargs": "^17.3.1"
   },
   "devDependencies": {
     "@types/jest": "^27.0.3",
     "@types/lodash": "^4.14.178",
     "@types/node": "^17.0.0",
+    "@types/shell-quote": "^1.7.1",
     "@types/supports-color": "^8.1.1",
+    "@types/yargs": "^17.0.8",
     "@typescript-eslint/eslint-plugin": "^5.8.1",
     "@typescript-eslint/parser": "^5.8.1",
-    "coveralls": "^3.1.0",
-    "eslint": "^7.17.0",
-    "jest": "^26.6.3",
-    "jest-create-mock-instance": "^1.1.0",
-    "ts-jest": "^26.5.6",
+    "coveralls-next": "^4.1.2",
+    "eslint": "^8.15.0",
+    "jest": "^27.5.1",
+    "jest-create-mock-instance": "^2.0.0",
+    "ts-jest": "^27.1.4",
     "ts-node": "^10.4.0",
     "typescript": "^4.5.4"
   },
@@ -69,7 +72,8 @@
     "index.js",
     "index.mjs",
     "!**/fixtures",
-    "!**/*.spec.js"
+    "!**/*.spec.js",
+    "!**/*.spec.d.ts"
   ],
   "jest": {
     "preset": "ts-jest",

package/dist/bin/concurrently.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/command-parser/expand-npm-shortcut.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/command-parser/expand-npm-wildcard.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/command-parser/strip-quotes.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/command.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/completion-listener.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/concurrently.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/flow-control/input-handler.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/flow-control/kill-on-signal.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/flow-control/kill-others.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/flow-control/log-error.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/flow-control/log-exit.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/flow-control/log-output.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/flow-control/log-timings.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/flow-control/restart-process.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/get-spawn-opts.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/logger.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/output-writer.spec.d.ts

@@ -1 +0,0 @@
-export {};