https://github.com/jofas/barekeeper
The bare-metal bookkeeper for your terminal
https://github.com/jofas/barekeeper
accounting bare-metal bookkeeping cli extensible freelancer no-vendor-lock
Last synced: 3 months ago
JSON representation
The bare-metal bookkeeper for your terminal
- Host: GitHub
- URL: https://github.com/jofas/barekeeper
- Owner: jofas
- License: mit
- Created: 2022-05-19T17:21:57.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-04-03T16:03:21.000Z (6 months ago)
- Last Synced: 2025-07-08T06:05:11.590Z (3 months ago)
- Topics: accounting, bare-metal, bookkeeping, cli, extensible, freelancer, no-vendor-lock
- Language: Python
- Homepage:
- Size: 3.51 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 
> Thus said the LORD unto Moses, thou shalt not force a software
> developer to leave their terminal.
>
> Thou shalt not use a mouse, it is of its father the devil.
>
> ~ Exodus 20:27-28
Generates invoice PDFs from structured data using a LaTeX template.
The data is provided by a `json/jsonnet` file.
Also supports the generation of business letters.
## Example
The example documents in the `examples/` dir are generated via:
```bash
sh generate_examples.sh
```
**Note:** the number in the filename of the generated PDF comes from
the `invoice_nr`/`letter_nr` provided by the `json` input.
### Time Management
#### How many work hours per month for a project X
```bash
python3 -m BAREKEEPER time \
--filter='p=="X"' \
--group_by="d.y,d.m" \
--transformer="BAREKEEPER.tf.sum_hours" \
time_sheet.json
```
## Dependencies
* `tex-live (linux/macOs)` or `MikeTeX (Windows)` with
`lualatex` installed
* `python 3`
* python deps: `jinja2`, `python-dateutil`, `lark`, `fire`
* python dev deps: `pytest`, `autopep8`