rtsort 0.3.2

A real-time `sort` with a live terminal preview.
Documentation 
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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98

# rtsort

A real-time `sort` with a live terminal preview.

`rtsort` is a streaming alternative to the standard `sort` command. It displays a continuously updated preview of your sorted data as it arrives, then seamlessly writes the final output to stdout.

## Features

- Live terminal display updates as each line arrives
- Alphabetical, numeric, and human-readable numeric sort modes
- Reverse ordering
- Limit output to the top N results

## Install

### Install with Cargo from crates.io

```bash
cargo install rtsort
```

### Download a release binary

Download the archive for your platform from the [GitHub Releases page](https://github.com/pinelibg/rtsort/releases), extract it, and place the `rtsort` binary somewhere on your `PATH`.

### Install with Cargo from the repository

```bash
cargo install --git https://github.com/pinelibg/rtsort.git
```

If your GitHub access uses SSH:

```bash
cargo install --git ssh://git@github.com/pinelibg/rtsort.git
```

### Build from a local clone

```bash
git clone https://github.com/pinelibg/rtsort.git
cd rtsort
cargo install --path .
```

## Usage

```
rtsort [OPTIONS]

Options:
  -n, --numeric-sort          Compare by string numerical value
  -h, --human-numeric-sort    Compare by human-readable numeric values (e.g. 2K, 1G)
  -r, --reverse               Reverse the sort order
  -t, --top <N>               Output only the first N lines of the sorted result
      --help                  Print help
```

### Examples

```bash
# Alphabetical sort (default)
printf 'pear\napple\nbanana\n' | rtsort

# Numeric sort
printf '10\n2\n30\n' | rtsort -n

# Human-readable numeric sort
printf '1K\n50\n2M\n' | rtsort -h

# Reverse sort
printf 'a\nc\nb\n' | rtsort -r

# Show only the top 3 results
printf '5\n1\n4\n2\n3\n' | rtsort -n --top 3

# Sort directories by size (human-readable)
du -sh */ | rtsort -h

# Find the 5 largest directories
du -sh */ | rtsort -hr --top 5
```

## Development

```bash
cargo build
cargo test
cargo clippy --all-targets -- -D warnings
cargo fmt --check
```

To try without installing:

```bash
printf 'pear\napple\nbanana\n' | cargo run
printf '10\n2\n30\n' | cargo run -- -n
```