Caching

Der Python-Client verwendet ETag-basierte bedingte HTTP-Anfragen, um unveränderte Dateien nicht erneut herunterladen zu müssen.

Funktionsweise

Beim ersten Download speichert der Client die Datei und ihren ETag unter ~/.cache/jmail/
Bei nachfolgenden Anfragen sendet der Client eine bedingte HEAD-Anfrage mit If-None-Match: <etag>
Wenn der Server mit 304 Not Modified antwortet, wird die zwischengespeicherte Datei verwendet (kein Download)
Wenn sich der ETag geändert hat, wird die Datei erneut heruntergeladen

~/.cache/jmail/
  emails.parquet
  emails.etag
  emails-slim.parquet
  emails-slim.etag
  documents.parquet
  documents.etag
  ...

client = JmailClient(cache=False)

uv run jmail.py emails --no-cache --head 5

rm -rf ~/.cache/jmail/

Der Endpunkt /v1/manifest.json stellt Metadaten zu Datensätzen und Prüfsummen bereit und ermöglicht programmatische Prüfungen auf Aktualität:

curl https://data.jmail.world/v1/manifest.json | python -m json.tool

client = JmailClient()
manifest = client.manifest()
print(manifest)