AGENTS.md

Projekt

Kleiner Docker-Container, der Cloudflare-A-Records (DNS-only) + eine FreeDNS-URL mit der aktuellen öffentlichen IPv4-Adresse pflegt. IP wird ausschließlich über die FritzBox TR-064-Schnittstelle ermittelt.

Kontext: SPEC.md (Design), PLAN.md (Tasks), README.md (Betrieb).

Struktur

app/ – Kernmodule (Python 3.12)
- config.py – ENV-basierte Konfiguration + Validierung
- state.py – persistierte letzte IP (/app/data/last-known-ip.json, ephemeral im Container)
- fritzbox.py – IP-Ermittlung via TR-064 (Retry/Backoff)
- cloudflare.py – A-Record-Update (DNS-only)
- freedns.py – FreeDNS-Update-Call
- healthcheck.py – Healthchecks-Pings
- main.py – Flask-Webhook (/webhook/update, /healthz) + Poll-Scheduler
.env.example – Referenz aller ENV-Variablen (Pflicht: FRITZBOX_, CLOUDFLARE_)

Befehle

Tests: keine Test-Suite vorhanden
Lint/Format: ruff check . und ruff format --check . (in .venv via python3 -m venv .venv && . .venv/bin/activate)
Lokal: python -m app.main (im .venv, deps aus requirements.txt)
Container: docker compose up -d

Konventionen

CREDENTIALS NIE committen. .env ist gitignored – nie mit -f hinzufügen.
Keine Co-Autoren in Commits.
Keine Kommentare im Code außer auf Nachfrage.
Python-Code mit Ruff formatieren (line-length 100, double quotes).
Änderungen an SPEC.md/PLAN.md/README.md mitziehen, wenn sich Design/Betrieb ändert.

License

Full text in LICENSE
License headers in all source code files

1.7 KiB Raw Permalink Blame History Unescape Escape