Installing the `term-transcript` executable

Assuming you have Rust/Cargo installed, run this command in a terminal:

cargo install term-transcript-cli

It will make the term-transcript command available in your PATH if you've allowed the PATH to be modified when installing Rust. cargo uninstall term-transcript-cli uninstalls.

Back to the crate overview.

Readme

term-transcript CLI

This crate provides command-line interface for term-transcript. It allows capturing terminal output to SVG and testing the captured snapshots.

Installation

Install with

cargo install --locked term-transcript-cli
# This will install `term-transcript` executable, which can be checked
# as follows:
term-transcript --help

See the Book for more installation options.

Usage

The capture subcommand captures output from stdin, renders it to SVG and outputs SVG to stdout.
The exec subcommand executes one or more commands in the shell, captures their outputs, renders to an SVG image and outputs it to stdout.
The test subcommand allows testing snapshots from the command line.
The print subcommand parses an SVG snapshot and outputs it to the command line.

Launch the CLI app with the --help option for more details about arguments for each subcommand. See the Book for more detailed overview of command-line args and options.

Examples

This example creates a snapshot of the rainbow script and then tests it.

Testing rainbow example

The snapshot itself is tested, too! It also shows that SVG output by the program is editable; in the snapshot, this is used to highlight command-line args and to change color of comments in the user inputs.

The test command can compare colors as well:

Testing color match

Another snapshot created by capturing help output from a pseudo-terminal (the --pty flag):

Output of test-transcript --help

Using PTY enables coloring output by default and formatting dependent on the terminal size.

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in term-transcript by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Installing the term-transcript executable

Installing the `term-transcript` executable