her-sync 0.3.0__tar.gz

her_sync-0.3.0/.gitignore

@@ -0,0 +1,20 @@
+.env
+.venv/
+__pycache__/
+*.pyc
+.pytest_cache/
+.ruff_cache/
+*.egg-info/
+dist/
+build/
+share/
+
+# Share-Verzeichnis enthält sensible Daten
+share/data/
+share/inbox/
+share/outbox/
+share/complete/
+
+# Browser-Session für manuelles Login
+.sessions/
+playwright-state/

her_sync-0.3.0/PKG-INFO

@@ -0,0 +1,115 @@
+Metadata-Version: 2.5
+Name: her-sync
+Version: 0.3.0
+Summary: Linux-native Sync-Tool für Agent-Share-Filesysteme (BDE, Email, CalDAV)
+Requires-Python: >=3.11
+Requires-Dist: beautifulsoup4>=4.12
+Requires-Dist: caldav>=1.3
+Requires-Dist: httpx>=0.27
+Requires-Dist: icalendar>=6.0
+Requires-Dist: keyring>=25.0
+Requires-Dist: lxml>=5.0
+Requires-Dist: openpyxl>=3.1
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0
+Requires-Dist: typer[all]>=0.12
+Provides-Extra: dev
+Requires-Dist: build>=1.0; extra == 'dev'
+Requires-Dist: playwright>=1.40; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Requires-Dist: twine>=5.0; extra == 'dev'
+Provides-Extra: release
+Requires-Dist: build>=1.0; extra == 'release'
+Requires-Dist: twine>=5.0; extra == 'release'
+Provides-Extra: watch
+Requires-Dist: watchdog>=4.0; extra == 'watch'
+Description-Content-Type: text/markdown
+
+# her-sync
+
+Linux-native Sync-Tool für Agent-Share-Filesysteme (BDE, Email, CalDAV).  
+CLI-Befehl: **`her`**
+
+## Installation
+
+```bash
+pipx install "her-sync[watch]"
+```
+
+Aus Git:
+
+```bash
+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 + watch
+│   ├── 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.
+
+```yaml
+# local.yml — optional, überschreibt Teile aus calendar.yml o.ä.
+caldav:
+  months_past: 6
+```
+
+```bash
+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
+
+```bash
+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
+
+```bash
+her daemon run --profile bde-work
+./deploy/systemd-install.sh bde-work
+systemctl --user start her@bde-work
+```
+
+## Release (Repo-Checkout)
+
+```bash
+her secrets set release/her-pypi-token   # einmalig lokal
+./scripts/her-release release --bump patch --pypi
+```
+
+Details: [deploy/DISTRIBUTION.md](deploy/DISTRIBUTION.md)

her_sync-0.3.0/README.md

@@ -0,0 +1,86 @@
+# her-sync
+
+Linux-native Sync-Tool für Agent-Share-Filesysteme (BDE, Email, CalDAV).  
+CLI-Befehl: **`her`**
+
+## Installation
+
+```bash
+pipx install "her-sync[watch]"
+```
+
+Aus Git:
+
+```bash
+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 + watch
+│   ├── 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.
+
+```yaml
+# local.yml — optional, überschreibt Teile aus calendar.yml o.ä.
+caldav:
+  months_past: 6
+```
+
+```bash
+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
+
+```bash
+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
+
+```bash
+her daemon run --profile bde-work
+./deploy/systemd-install.sh bde-work
+systemctl --user start her@bde-work
+```
+
+## Release (Repo-Checkout)
+
+```bash
+her secrets set release/her-pypi-token   # einmalig lokal
+./scripts/her-release release --bump patch --pypi
+```
+
+Details: [deploy/DISTRIBUTION.md](deploy/DISTRIBUTION.md)

her_sync-0.3.0/calendar_filters.yaml

@@ -0,0 +1,7 @@
+# Nextcloud CalDAV — welche Kalender exportiert werden
+# Leer lassen oder alle Einträge entfernen = alle Kalender des Users
+#
+# Namen entsprechen dem Anzeigenamen oder dem URL-Segment (z. B. personal)
+
+calendars:
+  - name: personal

her_sync-0.3.0/deploy/DISTRIBUTION.md

@@ -0,0 +1,56 @@
+# Distribution
+
+Paket: **her-sync** auf PyPI  
+CLI: **`her`**
+
+```bash
+pipx install her-sync
+# oder mit Watch-Extra:
+pipx install "her-sync[watch]"
+
+# Aus Git:
+pipx install --force "git+https://gitea.example.com/you/her-sync@v0.3.0#egg=her-sync[watch]"
+
+# Lokaler Checkout:
+pipx install --force ".[watch]"
+```
+
+## Release
+
+```bash
+pip install -e ".[dev]"   # build + twine für Publish
+
+# Lokal: Tag + pipx
+./scripts/her-release release --bump patch
+
+# Mit PyPI-Upload (Keyring):
+her secrets set release/her-pypi-token
+./scripts/her-release release --bump patch --pypi
+
+# Nur Upload (ohne Git-Tag):
+./scripts/her-release publish
+```
+
+### PyPI-Token
+
+| Quelle | Wann |
+|---|---|
+| `HER_PYPI_TOKEN` | CI — bevorzugt |
+| `TWINE_PASSWORD` | CI-Fallback (twine-kompatibel) |
+| Keyring `release/her-pypi-token` | Lokal (Default) |
+| `HER_PYPI_KEYRING` / `--pypi-keyring` | Anderer Keyring-Ref |
+
+```bash
+# Lokal einmalig
+her secrets set release/her-pypi-token
+
+# CI (Gitea/GitHub Actions)
+export HER_PYPI_TOKEN=pypi-AgEI...
+./scripts/her-release release --bump patch --pypi --no-pipx
+```
+
+Keyring-Service bleibt `her-sync` — Release-Refs unter `release/…`, getrennt von Profil-Secrets (`bde-work/…`).
+
+## Config
+
+`~/.her/` — Keyring-Service: `her-sync`

her_sync-0.3.0/deploy/calendar.example.yml

@@ -0,0 +1,10 @@
+caldav:
+  enabled: true
+  url: https://nc.example.com/remote.php/dav/calendars/USER/
+  user: USER
+  email: USER@example.com
+  password: {keyring: bde-work/caldav-password}
+  months_past: 12
+  months_future: 12
+  calendars:
+    - name: personal

her_sync-0.3.0/deploy/config.example.yml

@@ -0,0 +1,2 @@
+# ~/.her/config.yml
+default_profile: bde-work

her_sync-0.3.0/deploy/crm.example.yml

@@ -0,0 +1,9 @@
+bde:
+  enabled: true
+  base_url: http://crm.local:3000
+  company_id: 1
+  basic_auth_user: api
+  basic_auth_pass: {keyring: bde-work/bde-basic-pass}
+  login: api
+  password: {keyring: bde-work/bde-password}
+  receipts_source: ~/Documents/Belege/incoming

her_sync-0.3.0/deploy/her@.service

@@ -0,0 +1,11 @@
+[Unit]
+Description=Agent-Sync watcher (%i)
+After=network-online.target
+
+[Service]
+ExecStart=%h/.local/bin/her daemon run --profile %i
+Restart=on-failure
+RestartSec=5
+
+[Install]
+WantedBy=default.target

her_sync-0.3.0/deploy/mail.example.yml

@@ -0,0 +1,9 @@
+email:
+  enabled: true
+  mode: mbox
+  betterbird_profile: ~/.var/app/eu.betterbird.Betterbird/.thunderbird/PROFILE.default-default
+  filters:
+    - name: unread-inbox
+      folders:
+        - ImapMail/imap.gmail.com/INBOX
+      unread_only: true

her_sync-0.3.0/deploy/profile.example.yml

@@ -0,0 +1,8 @@
+# ~/.her/profiles/bde-work/profile.yml
+share: ~/.her/share-bde
+
+watch:
+  debounce_seconds: 10
+  on_email_change:
+    - email
+    - caldav

her_sync-0.3.0/deploy/systemd-install.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+set -euo pipefail
+PROFILE="${1:-bde-work}"
+UNIT_DIR="${HOME}/.config/systemd/user"
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+mkdir -p "$UNIT_DIR"
+cp "${SCRIPT_DIR}/her@.service" "${UNIT_DIR}/"
+systemctl --user daemon-reload
+systemctl --user enable "her@${PROFILE}.service"
+echo "Installiert: her@${PROFILE}"
+echo "Start: systemctl --user start her@${PROFILE}"

her_sync-0.3.0/email_filters.yaml

@@ -0,0 +1,26 @@
+# E-Mail Export-Filter (Betterbird mbox, relativ zu BETTERBIRD_PROFILE)
+# Export nach: share/data/inbox/emails/<name>/<YYYYMMDD_HHMMSS>_<hash>/ (UTC)
+#
+# Pro Filter:
+#   folders     — mbox-Ordner (mehrere möglich)
+#   unread_only — nur ungelesene Mails (X-Mozilla-Status)
+#   tags        — Betterbird-Tags (X-Mozilla-Keys), mindestens einer muss passen
+#   months_past — 0 = kein Datumsfilter; >0 = nur Mails der letzten N Monate
+#   trust_gloda_read — bei unread_only: Gloda-Read-Status nutzen wenn MSF noch
+#                      „ungelesen“ zeigt (Betterbird schreibt .msf verzögert)
+#
+# Beim nächsten Sync werden Exporte gelöscht, die nicht mehr passen.
+
+filters:
+  - name: unread-inbox
+    folders:
+      - ImapMail/imap.gmail.com/INBOX
+    unread_only: true
+
+  # - name: rechnungen
+  #   folders:
+  #     - ImapMail/imap.gmail.com/[Gmail].sbd/Geschäftlich.sbd/Rechnungen
+  #     - ImapMail/imap.gmail.com/[Gmail].sbd/Geschäftlich.sbd/Steuer
+  #   months_past: 3
+  #   tags:
+  #     - Steuer

her_sync-0.3.0/pyproject.toml

@@ -0,0 +1,38 @@
+[project]
+name = "her-sync"
+version = "0.3.0"
+description = "Linux-native Sync-Tool für Agent-Share-Filesysteme (BDE, Email, CalDAV)"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "typer[all]>=0.12",
+    "httpx>=0.27",
+    "beautifulsoup4>=4.12",
+    "lxml>=5.0",
+    "openpyxl>=3.1",
+    "pydantic>=2.0",
+    "rich>=13.0",
+    "caldav>=1.3",
+    "icalendar>=6.0",
+    "pyyaml>=6.0",
+    "keyring>=25.0",
+]
+
+[project.optional-dependencies]
+watch = ["watchdog>=4.0"]
+dev = ["pytest>=8.0", "ruff>=0.4", "playwright>=1.40", "build>=1.0", "twine>=5.0"]
+release = ["build>=1.0", "twine>=5.0"]
+
+[project.scripts]
+her = "her_sync.cli:app"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/her_sync"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"

her_sync-0.3.0/scripts/her-release

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+set -euo pipefail
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+cd "$ROOT"
+PYTHON="${ROOT}/.venv/bin/python"
+if [[ ! -x "$PYTHON" ]]; then
+  PYTHON="$(command -v python3)"
+fi
+exec "$PYTHON" "${ROOT}/scripts/release_cli.py" "$@"