acc 0.3.0

plaintext double-entry accounting command line tool
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

# 01 — Basics

The minimal journey: a single-currency journal, the core report
commands, and what each produces.

## Journal

```
2024-01-01 (opening) initial balances
    assets:checking           $5000.00
    equity:opening           $-5000.00

2024-01-05 (42) Groceries
    expenses:food              $58.20
    assets:checking

2024-01-10 * paycheck
    assets:checking           $2500.00
    income:salary            $-2500.00
```

Three transactions, one commodity (`$`), one omitted amount — the
booker fills in `assets:checking $-58.20` on the Groceries tx by
inferring the missing side from the other posting.

## `bal` — balances grouped by account

```
$ acc -f journal.ledger bal
 $7441.80 assets
 $7441.80   checking
$-5000.00 equity
$-5000.00   opening
   $58.20 expenses
   $58.20   food
$-2500.00 income
$-2500.00   salary
---------
        0
```

Hierarchical tree by default. `--flat` gives one line per account.
`-E` / `--empty` adds zero-balance accounts to the output (hidden
by default).

## `reg` — transaction register with running total

```
$ acc -f journal.ledger reg
2024-01-01 initial balances  assets:checking   $5000.00  $5000.00
                             equity:opening   $-5000.00         0
2024-01-05 Groceries         expenses:food       $58.20    $58.20
                             assets:checking    $-58.20         0
2024-01-10 * paycheck        assets:checking   $2500.00  $2500.00
                             income:salary    $-2500.00         0
```

Per-tx running total in the rightmost column, zeros out after each
balanced transaction.

## `print` — normalised vs raw

Normal mode fills in computed amounts:

```
$ acc -f journal.ledger print
2024-01-01   (opening) initial balances
    assets:checking     $5000.00
    equity:opening     $-5000.00

2024-01-05   (42) Groceries
    expenses:food         $58.20
    assets:checking      $-58.20

2024-01-10 * paycheck
    assets:checking     $2500.00
    income:salary      $-2500.00
```

`--raw` dumps the original source bytes unchanged:

```
$ acc -f journal.ledger print --raw
2024-01-01 (opening) initial balances
    assets:checking           $5000.00
    equity:opening           $-5000.00

2024-01-05 (42) Groceries
    expenses:food              $58.20
    assets:checking

2024-01-10 * paycheck
    assets:checking           $2500.00
    income:salary            $-2500.00
```

## `accounts`, `commodities`, `codes`

List views of the journal's dimensions:

```
$ acc -f journal.ledger accounts
assets:checking
equity:opening
expenses:food
income:salary
```

```
$ acc -f journal.ledger commodities
$
```

```
$ acc -f journal.ledger codes
42
opening
```