1
0
Fork
You've already forked rainlog
0
Simple CLI tools to keep a record of daily rainfall records.
  • Python 98.1%
  • Just 1.9%
2026年07月13日 14:11:27 +10:00
.forgejo/workflows 👷 replace curl|sh with pip install uv in weekly-checks 2026年07月13日 06:24:38 +10:00
docs 📝 document comparison mode and fix year-cap and color palette bounds 2026年07月13日 11:33:22 +10:00
src/rainlog 🐛 fix comparison mode + key using wrong year-count query 2026年07月13日 11:55:04 +10:00
tests 📝 document comparison mode and fix year-cap and color palette bounds 2026年07月13日 11:33:22 +10:00
.editorconfig
.gitignore 🔧 relocate .superpowers folder, update gitignore 2026年07月12日 20:43:42 +10:00
.pre-commit-config.yaml 🔧 make complexipy look at test files as well 2026年07月13日 10:54:12 +10:00
.python-version
.secrets.baseline
AI-DECLARATION.md 📝 add AI-DECLARATION.md 2026年07月12日 20:46:12 +10:00
CHANGELOG.md docs: update changelog for 1.1.0 2026年07月13日 13:48:16 +10:00
CLAUDE.md 📝 reference Release-Notes.md.template instead of embedding a copy 2026年07月13日 06:43:37 +10:00
improvements.md 📝 document comparison mode and fix year-cap and color palette bounds 2026年07月13日 11:33:22 +10:00
justfile 🔧 refactor changelog generation, remove git-cliff 2026年07月12日 20:50:57 +10:00
mkdocs.yml
noxfile.py
pylock.toml 🔧 refactor changelog generation, remove git-cliff 2026年07月12日 20:50:57 +10:00
pyproject.toml 🔧 bump: version 1.0.1 → 1.1.0 2026年07月13日 13:48:19 +10:00
README.md 📝 rewrite README with badges and TUI-first content 2026年07月02日 08:45:46 +10:00
Release-Notes.md 📝 reset Release-Notes.md for next release 2026年07月13日 14:11:27 +10:00
Release-Notes.md.template ✨ add Release-Notes.md and template 2026年07月12日 20:48:01 +10:00
ruff.toml
uv.lock 🔧 bump: version 1.0.1 → 1.1.0 2026年07月13日 13:48:19 +10:00

rainlog

PyPI version Python versions License: AGPL-3.0 CI Docs

A terminal-based rain logger. Record daily rainfall totals in a local SQLite database and explore history through an interactive TUI.

License: AGPL-3.0-or-later

Python: 3.11–3.14

Install

From the repository root (with uv recommended):

uv sync

Or install the package into your environment:

uv pip install .

The console entry point is rainlog.

Usage

Run the TUI:

rainlog
Key Action
n Add a rain record
e Edit a record (use s to select a bar first in daily view)
← / → Scroll history back / forward
g Cycle grouping (daily / weekly / monthly / yearly)
m Toggle chart mode (rainfall ↔ soil-moisture index)
+ / - More / fewer bars
a Auto bar count
q Quit

Data storage

  • By default, data lives in rainlog.sqlite in ~/.local/share/rainlog/.
  • Use --db-dir to put the database in another directory (the filename stays rainlog.sqlite).
  • Each row stores the rain total in millimetres for a 24-hour block ending at 09:00 local time on the given calendar day.

Development

Tests and automation are driven by Nox; list sessions with nox -l and run the ones you need (e.g. tests).

Links