traceviewer 0.1.3

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
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

# 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

Install a prebuilt binary with `cargo-binstall`:

```sh
cargo binstall traceviewer
```

Or build from source with Cargo:

```sh
cargo install traceviewer
```

The installed binary is named `tv`.

## Usage

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

By default, `traceviewer` attempts to recognize supported formats automatically.
Use `--format` to choose one explicitly:

- `auto`: detect supported formats
- `plain`: show lines without parsing
- `bunyan`: Bunyan JSON records
- `env-logger`: common `env_logger` text output
- `tracing`: common `tracing` text output

## Showcase Example

The repository includes a small example app that emits representative log lines
for each supported parser:

```sh
cargo run --example showcase -- env-logger
cargo run --example showcase -- tracing
cargo run --example showcase -- bunyan
```

Run it through `tv` to inspect the rendering:

```sh
cargo run --bin tv -- --format env-logger -- cargo run --example showcase -- env-logger
cargo run --bin tv -- --format tracing -- cargo run --example showcase -- tracing
cargo run --bin tv -- --format bunyan -- cargo run --example showcase -- bunyan
```

## License

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