stax 0.42.2

Fast stacked Git branches and PRs
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

# Benchmarks

Absolute times vary by repo and machine. These `hyperfine` samples were captured in this repo.

| Command | [stax](https://github.com/cesarferreira/stax) | [freephite](https://github.com/bradymadden97/freephite) | [graphite](https://github.com/withgraphite/graphite-cli) |
|---|---:|---:|---:|
| `ls` | 45.5ms | 739.7ms | 457.7ms |
| `rs` | 2.807s | 6.769s | — |

```text
  ls — mean execution time (lower is better)

  stax       ███                                                45.5 ms
  graphite   ███████████████████████████████                   457.7 ms
  freephite  ██████████████████████████████████████████████████ 739.7 ms
             ┬─────────┬─────────┬─────────┬─────────┬─────────┬
             0        150       300       450       600       750 ms
```

`gt sync` was not included in this sample set, so the `rs` row does not include a Graphite comparison.

Summary from the sample runs:

- `st ls` was ~16.25x faster than `fp ls`
- `st ls` was ~10.05x faster than `gt ls`
- `st rs` was ~2.41x faster than `fp rs`

## `ls`

Command:

```bash
hyperfine 'stax ls' 'fp ls' 'gt ls' --warmup 2
```

Raw output:

```text
Benchmark 1: stax ls
  Time (mean ± σ):      45.5 ms ±   6.9 ms    [User: 10.0 ms, System: 12.0 ms]
  Range (min … max):    40.3 ms …  89.5 ms    59 runs

  Warning: Statistical outliers were detected. Consider re-running this benchmark on a quiet system without any interferences from other programs. It might help to use the '--warmup' or '--prepare' options.

Benchmark 2: fp ls
  Time (mean ± σ):     739.7 ms ±  23.9 ms    [User: 353.1 ms, System: 208.9 ms]
  Range (min … max):   705.2 ms … 769.8 ms    10 runs

Benchmark 3: gt ls
  Time (mean ± σ):     457.7 ms ±  96.8 ms    [User: 239.3 ms, System: 88.4 ms]
  Range (min … max):   355.0 ms … 647.4 ms    10 runs

Summary
  stax ls ran
   10.05 ± 2.61 times faster than gt ls
   16.25 ± 2.50 times faster than fp ls
```

## `rs`

Command:

```bash
hyperfine 'stax rs' 'fp rs'
```

Raw output:

```text
Benchmark 1: stax rs
  Time (mean ± σ):      2.807 s ±  0.129 s    [User: 0.365 s, System: 0.361 s]
  Range (min … max):    2.543 s …  3.006 s    10 runs

Benchmark 2: fp rs
  Time (mean ± σ):      6.769 s ±  0.717 s    [User: 0.673 s, System: 0.981 s]
  Range (min … max):    6.038 s …  7.824 s    10 runs

Summary
  stax rs ran
    2.41 ± 0.28 times faster than fp rs
```