Caching

Il client Python usa richieste condizionali basate su ETag per evitare di scaricare nuovamente i file non modificati.

Come funziona

Al primo download, il client salva il file e il suo ETag in ~/.cache/jmail/
Per le richieste successive, il client invia una richiesta HEAD condizionale con If-None-Match: <etag>
Se il server risponde con 304 Not Modified, viene usato il file dalla cache (nessun download)
Se l’ETag è cambiato, il file viene scaricato di nuovo

~/.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/

L’endpoint /v1/manifest.json fornisce i metadati dei dataset e i checksum, consentendo verifiche automatiche dello stato di aggiornamento:

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

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