pen-tracker/README.md

Pen Tracker

A simple fountain pen collection tracker.

Installation

pip install .

Data Storage

Pen data is stored in ~/.local/share/pen-tracker/pens.csv by default, following XDG Base Directory specification. The directory is created automatically if it doesn't exist.

You can override the location by setting the PEN_TRACKER_CSV environment variable.

Usage

CLI

Interactive mode:

pen-tracker

Command-line mode:

pen-tracker add --make "Pilot" --model "Metropolitan" --nib "F"
pen-tracker list
pen-tracker export --output my_pens.json

Features

• Track fountain pens with details like make, model, nib, ink, etc.
• CLI interface with interactive and command-line modes
• Data stored in CSV format
• Export to JSON
• Input validation for dates
• Configurable CSV path via PEN_TRACKER_CSV environment variable