cli_script

This was always intended for public use, it was just left out
accidentally.

This also makes a stable 1.0.0 release.

• Stable release.

• Expose the args() function, which shell-escapes multiple arguments at once.

• Update internal type annotations for compatibility with dart-lang/sdk#52801.

• Add Script.outputBytes, which works like Script.output but returns the raw bytes instead of a string representation.

• stream scripts can be interrupted, capturing scripts can't but their signal can be reacted to
• xargs won't execute a callback on the last chunk
• streams signal handlers no longer need to explicitly check for exit code

• Add Script.kill() to send a ProcessSignal such as SIGKILL or SIGTERM to terminate a script or stream. Defaults to SIGTERM. Capturing functions like Script.capture or silenceUntilFailure can't terminate their callbacks but the ProcessSignal can be reacted to via their new onSignal handler.

This parameter allows callers to silence or buffer only a script's
standard error and still handle its standard output.

• Add a stderrOnly parameter to BufferedScript.capture() and silenceUntilFailure(). If this parameter is true, only the stderr from the callbacks will be buffered or silenced, and the stdout will be emitted normally.

Add support for associating spans with line streams (#40)

• Add LineStreamExtensions.withSpans(), which adds SourceSpanWithContexts to a stream's lines for better error messaging and debugging.

• Add readWithSpans(), which adds SourceSpanWithContexts to a file's lines for better error messaging and debugging.

• Add LineAndSpanStreamExtensions, which provides various extension methods that preserve source spans.

Add a silenceUntilFailure() function (#39)

• Add a silenceUntilFailure() function that suppresses output for a block of code until it emits an error.

Co-authored-by: Jennifer Thakar [email protected]

• Add an onlyMatching flag to grep() which prints the sections of input lines that match the given regular expression.

• Add a teeToStderr transformer and extension method on Stream<List<String>>. This passes a stream to stderr without modifying it, which is useful for debugging.

• Add a Script.mapLines constructor that returns a script that maps stdin lines according to a String Function(String).

• Add support for passing a String Function(String) to Script.pipeline and Script.operator | to map stdin lines.

• Fold stack frames for a few more packages used internally.

Properly respect onlyMatching in the top-level grep() method (#35)

• Properly respect onlyMatching in the top-level grep() method.

Closes #11

• Documentation improvements only.

This buffers output from a Script until it's explicitly released,
making it easier to run multiple script in parallel without having
their outputs collide with one another.

• Add a BufferedScript class that buffers output from a Script until it's explicitly released, making it easier to run multiple script in parallel without having their outputs collide with one another.

• If the same capture() block both calls print() and writes to currentStdout, ensure that the order of prints is preserved.

• If the same capture() block writes to both currentStdout and currentStderr, ensure that the relative order of those writes is preserved when collected with combineOutput().

Add human-readable toStrings to StreamTransformers (#26)

• Give the stream transformers exposed by this package human-readable toString()s.

• Add a debug option to wrapMain() to print extra diagnostic information.

• Add a runInShell argument for subprocesses.

• Accept Iterable<String> instead of List<String> for subprocess arguments.

• Use 257 rather than 256 as the sentinel value for ScriptExceptions caused by Dart exceptions.

• Fix a bug where Dart exceptions could cause the script to exit before their debug information was printed to stderr.

• Initial release.