dinary 0.5.0

Server for [Dinary - your dinar diary](https://github.com/andgineer/dinary). Track expenses, scan receipts, analyze spending with AI

Dinary

Track expenses, scan receipts, analyze spending with AI

Documentation

Dinary

Local development

Install uv, then:

uv sync

# Create .deploy/.env from the template (one-time, .deploy/ is gitignored)
cp -r .deploy.example .deploy

# First time — or whenever you want a clean slate:
#   wipes data/dinary.db (and the WAL/SHM sidecars), runs schema migrations, seeds the
#   hardcoded 3D taxonomy (groups / categories / events / tags), then
#   starts uvicorn on http://127.0.0.1:8000 with auto-reload.
uv run inv dev --reset

# Subsequent runs — DB is preserved, migrations still apply on startup
# via the FastAPI lifespan, so editing a migration and restarting is
# enough (no separate ``inv migrate`` needed for the local DB):
uv run inv dev

inv dev disables Google-Sheets logging by default so test expenses you create while debugging don't leak into the prod logging spreadsheet (the env var from .deploy/.env is overridden just for this process). Pass --sheet-logging if you specifically want to exercise the drain loop end-to-end.

To point local dev at a copy of prod data instead of an empty DB:

uv run inv backup                         # snapshot prod into ~/Library/dinary/<ts>/
cp ~/Library/dinary/<ts>/data/dinary.db data/
uv run inv dev                            # NOT --reset; keep the snapshot

Credentials are read from ~/.config/gspread/service_account.json (standard gspread location). Don't have a service account key yet? See Google Sheets Setup.

Run tests

inv test

Pre-commit hooks

Use pre-commit for code quality:

pre-commit install

Scripts

Install invoke preferably with uv tool:

uv tool install invoke

For a list of available scripts run:

invoke --list

Deploy to Oracle Cloud

Configure .deploy/.env (see .deploy.example/.env), then:

inv setup-server    # one-time: install deps, clone, create systemd services, upload creds
inv deploy          # pull latest code and restart
inv status --remote # check service status
inv logs --remote   # tail server logs

See Oracle Cloud deployment guide for details.

Reports

• Allure test report
• Codecov
• Coveralls

Created with cookiecutter using template