Provides utility functions to prepare a child process command-line and set environment variables in that process.
addColorOption(array $args, string $colorOption) : array
Returns an array of parameters, including a color option if required
A color option is needed because child process output is piped.
| array | $args | The script parameters |
| string | $colorOption | The long option to force color output |
escape(string $arg, boolean $meta = true, boolean $module = false) : string
Escapes a string to be used as a shell argument.
From https://github.com/johnstevenson/winbox-args MIT Licensed (c) John Stevenson john-stevenson@blueyonder.co.uk
| string | $arg | The argument to be escaped |
| boolean | $meta | Additionally escape cmd.exe meta characters |
| boolean | $module | The argument is the module to invoke |
The escaped argument
supportsColor(mixed $output) : boolean
Returns true if the output stream supports colors
This is tricky on Windows, because Cygwin, Msys2 etc emulate pseudo terminals via named pipes, so we can only check the environment.
| mixed | $output | A valid CLI output stream |