tally-cli 1.2.0

A persistent, inter-process counter for all your shell scripts
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
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131

# tally

[![Crates.io](https://img.shields.io/crates/v/tally-cli.svg)](https://crates.io/crates/tally-cli)
![Docker Image Version](https://img.shields.io/docker/v/uhryniuk/tally/latest?color=blue&label=docker)

A CLI tool to manage global counters from the command line. 

Written in Rust with SQLite, it's a process-safe way to keep count across your system.

## Installation

### Cargo

Tally is published to [crate.io](https://crates.io/) and is easily installed with the following command.

```
cargo install tally-cli
```

### Docker

You can also play around with tally in a container.

```
docker run --name tally --rm -it docker.io/uhryniuk/tally
```

### Build

Alternatively, you can build it locally.

```
git clone https://github.com/uhryniuk/tally.git
cd tally
cargo build --release
```

## Getting started

Tally will create the sqlite database upon first invocation, the database is written to `~/.tally/tally.db`.

```bash
$ tally
0

$ tally list
Name   Count  Step  Template  Default
tally  0      1     {}        *

```

Adding and subtracting from counters is quite straight-forward.

```
$ tally add
1

# tally add 5
6

$ tally new-counter add 5
5

$ tally list
Name         Count  Step  Template  Default
tally        6      1     {}        *
new-counter  5      1     {}
```

Setting the default counter is possible too

```bash

$ tally new-counter set --default

$ tally list
Name         Count  Step  Template  Default
tally        6      1     {}
new-counter  5      1     {}        *
```

You can also change how much the counter steps each invocation

```bash

$ tally set --step 5

$ tally add
10

$ tally list
Name         Count  Step  Template  Default
tally        6      1     {}
new-counter  10     5     {}        *
```

Templating and referencing counters between each other is supported.

```bash

$ tally set --template "new-counter: {}"
$ tally
new-counter: 10

$ tally set --template "new-counter: {}, tally: {tally}"
$ tally add
new-counter: 11, tally: 6

$ tally list
Name         Count  Step  Template                         Default
tally        6      1     {}
new-counter  11     5     new-counter: {}, tally: {tally}  *
```

Need to clean up the counters? Simple run the `nuke` subcommand.

```bash

$ tally nuke
Are you sure wish to nuke? (y/n): y
Database deleted successfully.

$ tally list
Name   Count  Step  Template  Default
tally  0      1     {}        *
```

## Acknowledgements

Created by `uhryniuk`. Licensed under the [GPL-3.0 license](LICENSE).