traceviewer 0.1.0

Run a command and inspect its logs in a scrollable terminal viewer
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

# traceviewer

[![CI](https://github.com/ctron/traceview/actions/workflows/ci.yml/badge.svg)](https://github.com/ctron/traceview/actions/workflows/ci.yml)
[![crates.io](https://img.shields.io/crates/v/traceviewer.svg)](https://crates.io/crates/traceviewer)

`traceviewer` runs a command and shows its output in a scrollable terminal log
viewer.

It is useful for inspecting long-running command output while keeping recent
log lines selectable, searchable by eye, and copyable from inside the terminal.

## Install

```sh
cargo install traceviewer
```

The installed binary is named `tv`.

## Usage

```sh
tv -- cargo test
tv --format tracing -- my-service
tv --max-lines 5000 -- ./run.sh
```

By default, `traceviewer` attempts to recognize common `env_logger` and
`tracing` text output. Use `--format plain`, `--format env-logger`, or
`--format tracing` to choose a parser explicitly.

## Controls

```text
Up / Down       move cursor one line
PgUp / PgDown   move cursor one page
Home / End      jump to first or last retained line
Left / Right    scroll horizontally
y               copy selected line to clipboard
?               toggle help
q / Esc         exit after the process ends
Ctrl-C          kill process and exit
```

## License

This project is licensed under the terms in `LICENSE`.