her-sync

Linux-native Sync-Tool für Agent-Share-Filesysteme (BDE, Email, CalDAV).
CLI-Befehl: her

Installation

pipx install "her-sync[watch]"

Aus Git:

pipx install --force "git+https://gitea.example.com/you/her-sync@main#egg=her-sync[watch]"

Entwicklung: pip install -e ".[watch,dev]"

Konfiguration

~/.her/

~/.her/
├── config.yml
├── profiles/bde-work/
│   ├── profile.yml       # share
│   ├── crm.yml           # bde: { ... }
│   ├── mail.yml          # email: { ... }
│   ├── calendar.yml      # caldav: { ... }
│   └── local.yml         # optional: Overrides (alphabetisch später = gewinnt)
├── state/bde-work/
└── share-bde/            # optional — Share kann auch woanders liegen

Alle .yml-Dateien im Profilordner werden alphabetisch geladen und deep-gemergt. Welches Plugin aktiv ist, ergibt sich nur aus dem YAML-Key (bde:, email:, caldav:) — der Dateiname spielt keine Rolle. Fehlender Key = Plugin deaktiviert.

# local.yml — optional, überschreibt Teile aus calendar.yml o.ä.
caldav:
  months_past: 6

her profile init bde-work
her profile migrate-env --env-file .env --name bde-work
her secrets set bde-work/bde-password
her --profile bde-work status

CLI

her profile list|show|init|migrate-env|validate
her secrets set|delete|test
her daemon run|start|stop|status
her status

her bde collect cashflows
her bde collect cashflow-history --force
her bde apply cost-centers --dry-run

her email sync
her caldav ls
her caldav sync

Daemon

her daemon run --profile bde-work
./deploy/systemd-install.sh bde-work
systemctl --user start her@bde-work

Release (Repo-Checkout)

her secrets set release/her-pypi-token   # einmalig lokal
./scripts/her-release release --bump patch --pypi

Details: deploy/DISTRIBUTION.md