Metadata-Version: 2.4
Name: medtrackerer
Version: 1.0.0
Summary: Generate a printable med chart for temporary medication courses
Author: Possumvibes
Author-email: Possumvibes <possumvibes@noreply.codeberg.com>
License-Expression: MIT
License-File: LICENSE
Requires-Dist: dacite>=1.9.2
Requires-Dist: jinja2>=3.1.6
Requires-Dist: weasyprint>=69.0
Requires-Python: >=3.14
Project-URL: Homepage, https://codeberg.org/possumvibes/medtrackerer
Description-Content-Type: text/markdown

# medtrackerer

**medtrackerer**
is an interactive CLI program to manage med tracking for short-term med courses
(e.g., after surgeries).
Medtrackerer uses a config file to track medication information and chart details
and outputs an opinionated med tracking chart design to printable PDF.

**"Opinionated"** here means that I am the primary user of this program,
and I am replicating a spreadsheet [REDACTED] has been maintaining manually for years
and that works very well for me personally.
The chart design is not customizeable at this time because this is a purely selfish project
to let me never touch a spreadsheet for med tracking again.

You can see an example pdf [here](./sample.pdf), based on a [sample config file](./sample.toml).

## Installation

Medtrackerer can be installed as a python package. Instructions for `uv` are provided.
```sh
# install latest release
uv tool install medtrackerer
```

## Usage
### Quickstart

Run `medtrackerer new` to interactively create a config file in your current working directory.

Run `medtrackerer generate path/to/config.toml` to generate the med chart PDF.

Check out the `--help` menus for quick reference on the command line.

### Creating a New Chart Config

Use `medtrackerer new` to interactively create a new med chart config.
Medtrackerer will confirm your inputs before saving the file.
The file name will be an escaped version of the name you specified,
so don't worry about making the name filename-friendly.

The config file will be a list of all the medications or tasks you want to track on the chart.
It serves as the configuration for the generated tracker chart and as a straightforward list for your reference!

Options:
```sh
# set the chart's name (and ask everything else)
medtrackerer new -n "My Cool Chart!"
# set the chart's start date to today
medtrackerer new -s 
# set the chart's start date to a specific date in year-month-day format
medtrackerer new -s 2025-06-17
```

### Adding to an Existing Chart Config

Use `medtrackerer add path/to/my_chart.toml` to add medications or tasks to an existing chart.
This uses the same interactive flow for medications as `medtrackerer new`.

**NB**: Medtrackerer supports additive edits only.
If you need to edit or remove an existing item, please edit your config file in your favorite text editor.

### Generating the Printable Chart

Use `medtrackerer generate ./path/to/my_chart.toml` to generate a printable PDF with all medication doses to be tracked.
This will output to `<CHART_FILENAME>.pdf` in the same directory.

**NB** Pagination is not supported (yet). One printout is good for about fourteen days of meds.

## Addendum

This was a project for me to learn Python.

No LLMs were or will be used in the making of this project.
