Downloader Riviste di Astronomia
Un servizio che controlla una casella email, scarica i PDF delle riviste astronomiche allegate come link e li archivia sul NAS per anno — senza doverlo fare a mano ogni volta.
Il problema
Ricevo periodicamente email con il link diretto al PDF di una rivista di astronomia. Scaricarli e archiviarli a mano, uno per uno, ordinandoli per anno, era la classica piccola scocciatura ripetitiva — perfetta da automatizzare.
Come funziona
Un piccolo servizio containerizzato controlla via IMAP una casella email self-hosted, cercando messaggi non letti con un link diretto a un PDF. Per ogni email trovata: scarica il file, lo salva sul NAS di casa in una cartella per anno (l’anno predefinito è quello di ricezione dell’email, non quello nel nome del file), e infine segna il messaggio come letto e lo sposta nel cestino. Un filtro opzionale su mittente e oggetto permette di restringere il controllo a una fonte specifica.
Il bug interessante: un server di posta che non parla lo standard atteso
Il passo più delicato non è stato il download, ma spostare l’email nel cestino dopo averla processata. Il server IMAP self-hosted usato non supporta due estensioni che quasi tutti danno per scontate: MOVE e UIDPLUS. Il primo tentativo di implementazione usava proprio queste, e falliva silenziosamente: l’email risultava letta ma restava bloccata nella posta in arrivo, senza essere spostata.
La soluzione è tornare al protocollo IMAP “di base”: copiare il messaggio nella cartella
Cestino, marcarlo con il flag \Deleted nella cartella originale e infine fare un
EXPUNGE semplice (non un UID EXPUNGE, che richiede proprio UIDPLUS). Un promemoria
utile: non tutti i server di posta, anche self-hosted, implementano le stesse estensioni
— vale la pena verificarlo prima di scrivere codice che le dà per scontate.
Le piccole cautele
Il servizio parte con una modalità dry-run (solo log, nessuna azione reale) prima di essere messo in produzione — un’abitudine che ha aiutato a validare la logica di filtraggio senza rischiare di perdere email per errore.
Stato
Completato e in produzione: il servizio controlla la casella periodicamente, scarica e archivia i PDF, e li marca correttamente come processati. Progetto chiuso — funziona senza manutenzione attiva.
Stack
Python · IMAPClient · BeautifulSoup · Docker · WSL2