cli_script 1.0.0

Write scripts that call subprocesses with the ease of shell scripting and the power of Dart.

1.0.0

• Stable release.

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

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

0.3.2

• Declare support for Dart 3.

0.3.1

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

0.3.0

• 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.

0.2.7

• Ensure that Scripts always cancel streams piped to their stdin sinks after exiting. This prevents rare cases where programs could deadlock waiting for events to be processed.

0.2.6

• 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.

0.2.5

• 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.

0.2.4

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

0.2.3+2

• Documentation improvements only.

0.2.3+1

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

0.2.3

• 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.

0.2.2

• 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().

0.2.1

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

0.2.0

• 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.

0.1.0

• Initial release.