documenti/test-da-stampare.md + stile-stampa.css -> test-da-stampare.pdf (5 pagine A4, 43 prove, 129 caselle, colonna 'sotto' per cio' che il banco ha gia' provato, spazio per le note, limiti noti in fondo).
harbour-grumpydove — GrumpyDove su Sailfish OS
Porting per Sailfish OS di GrumpyDove, il client di posta in stile Eudora scritto in Ada e Qt 6 da Uriel Fanelli: https://git.keinpfusch.net/loweel/grumpydove
L'interfaccia è riscritta in Silica/QML per il telefono; il motore è quello originale, compilato per aarch64 e collegato all'app: stessa gestione del Maildir, stesso IMAP, stesse regole di Eudora. Non è un client nuovo che somiglia all'originale — è l'originale con un'altra pelle.
Il motore viene dalla 1.0.0-beta10 più il fix del 16 novembre (commit 2276e7e); la versione
esatta e cosa è cambiato rispetto alle basi precedenti stanno in
engine/SORGENTE.md.
Grazie
A Uriel Fanelli per GrumpyDove: un client di posta scritto in Ada, da zero, seguendo il manuale di Eudora 7, con dentro IMAP, JMAP, CardDAV, PGP e S/MIME. È un progetto che dà da pensare su come si possa ancora scrivere software grande e serio senza seguire la moda del momento — e senza rinunciare a una interfaccia che si capisce al primo sguardo. Questo porting esiste perché quel lavoro c'era già: il merito del client è suo, i difetti di questa versione mobile sono miei.
Il progetto originale è EUPL-1.2; anche questo porting resta EUPL-1.2.
Stato: 0.22.0
Installabile e usabile: si legge e si manda la posta.
Funziona oggi:
- Cartelle dal motore, con conteggio dei non letti; account in cima e cartelle rientrate per profondità, come nell'albero di Eudora.
- Configurazione dell'account dentro l'app (IMAP: server, porta, STARTTLS/TLS, utente, password, quanti messaggi tenere per cartella; più l'indirizzo del mittente, che è il From dei messaggi in uscita).
- Scarico della posta con avanzamento a schermo, cartella per cartella.
- Elenco messaggi dal più nuovo al più vecchio, non letti in grassetto con barra a sinistra, filtro per i soli non letti.
- Lettura: mittente, data, oggetto, corpo in testo, posizione «3 di 12». Paginazione a tap: a destra il successivo, a sinistra il precedente, il corpo resta scorrevole al centro.
- Link attivi nel corpo (URL e indirizzi): si aprono nel browser o nel client di posta. Il testo è escapato prima di inserire i tag, così un messaggio non può iniettare HTML.
- Allegati: si salvano in Download e si aprono.
- Sposta in una cartella qualsiasi: dal menu del messaggio o con una pressione lunga sulla riga; la destinazione si sceglie fra le cartelle dell'account. È anche il modo per correggere un filtro.
- Creare una cartella dall'albero delle cartelle: il motore crea una Maildir vera (tmp, new, cur), non un contenitore vuoto.
- Segna letto/non letto, sposta nel cestino e svuota il cestino (due tocchi sulla voce di menù: è irreversibile). Lo svuotamento cancella anche sul server, non solo le copie locali.
- Messaggi HTML resi: la parte HTML si disegna (paragrafi, elenchi,
tabelle, grassetti, link toccabili), non si riduce a testo. Prima passa da un
filtro (
qml/js/htmlpulito.js) che toglie script, iframe, gestori di eventi, immagini remote — caricarle direbbe al mittente che hai aperto il messaggio — e i colori che sul tema scuro sarebbero illeggibili. «Vedi come testo» resta nel menu. Niente motore web. - Ricerca nei messaggi dal menù delle cartelle: risultati con mittente, oggetto e cartella; un tocco apre il messaggio.
- Rubrica CardDAV: si sincronizza il libro, i contatti restano in locale e un tocco apre la composizione con quell'indirizzo.
- Autocompletamento degli indirizzi: nel campo «A» i contatti della rubrica compaiono mentre si scrive e un tocco completa l'indirizzo. Vale per l'ultimo indirizzo del campo, quindi chi ne scrive due non perde il primo; se la rubrica non è stata aperta in quella sessione i contatti si leggono dal disco. Oltre alla rubrica si suggeriscono gli indirizzi già visti nei messaggi, così la funzione serve anche con la rubrica quasi vuota (mai il proprio indirizzo, mai due volte lo stesso).
- Filtri che imparano: il motore studia cosa c'è nelle cartelle (con bogofilter, incluso nel pacchetto) e archivia i messaggi simili; si comanda dal menu della cartella («Filtra i messaggi», «Filtri attivi»), e con i filtri attivi la posta appena scaricata viene archiviata da sola. Finché ha imparato poco, o se due cartelle se lo contendono, il messaggio resta in In: è la regola dell'originale, non una mancanza.
- Rispondi (con l'indirizzo vero del mittente, non solo il nome) e Rispondi a tutti (mittente, destinatari e copie, senza te e senza doppioni).
- Allegati in uscita: «Allega un file» apre il picker di Sailfish; i file
scelti compaiono in elenco e un tocco li toglie. Il motore li legge dal disco
e li spedisce (riga
Attacheddel foglio di composizione). - Invio: il messaggio entra nella coda del motore, parte con SMTP e la copia resta in Sent sul server. A, Cc, Bcc, Oggetto, Testo; esiti a schermo.
- Ordinamento per data, mittente, oggetto o dimensione, con il verso che si gira toccando di nuovo la stessa voce; l'ordine scelto resta per la cartella.
- Priorità (alta, normale, bassa), etichette 0-7 e junk / non junk sul messaggio: il junk sposta nella cartella giusta e addestra bogofilter.
- Risincronizza la cartella senza passare dal server, e salva tutti gli allegati in un colpo.
- Bozze: «Salva bozza» mette il messaggio in Drafts senza spedirlo; «Riprendi la bozza» riporta destinatari, copie, oggetto, testo e allegati nel modulo. Salvando di nuovo il motore sostituisce la bozza invece di crearne una seconda; dopo l'invio la bozza va nel cestino.
- Controllo automatico e notifica: la posta si controlla ogni N minuti (0 = solo a mano), e quando i non letti aumentano compare una notifica di sistema. La notifica non suona per un controllo che non porta niente.
- Copertina con i non letti totali.
- La posta resta dopo la chiusura: il Maildir vive nella cartella dati
dell'app, non in
~/Mail(vedi sotto).
Notifiche push (UnifiedPush)
La posta non ha un servizio push: il telefono non può tenere aperta una connessione IMAP quando è in tasca. La catena è quindi in due pezzi, come per l'app di localizzazione:
- l'app è un connector UnifiedPush: possiede
org.unifiedpush.Connector.harbour-grumpydove, si registra col distributore (FogHorn) e mostra in Account → Notifiche push l'endpoint ottenuto; - un watcher sul server guarda la casella (
packaging/push-watcher/) e, quando i non letti aumentano, manda un push vuoto a quell'endpoint.
Il push non porta dati — dice solo «guarda»: l'app si sveglia senza aprire
finestra (argomento per ambiente GRUMPYDOVE_PUSH_WAKE=1), controlla la posta
e pubblica la notifica.
Serve ntfy (o un gateway UnifiedPush): il servizio Mozilla rifiuta un corpo non cifrato, e cifrare non serve a niente perché il messaggio è solo un campanello. Senza push, la posta si controlla ogni N minuti (vedi sopra).
Cosa manca
- Immagini nei messaggi: si segnalano come «[immagine]», non si scaricano. Mostrarle richiederebbe di caricare contenuti remoti: una scelta di privacy, e anche una funzione in più da progettare (quali, quando, con quale consenso).
- Ricerca avanzata (per campo: da, a, oggetto, corpo, con più termini e confronti diversi): c'è la ricerca libera su tutto.
- Antispam con punteggio (bogofilter in arrivo e spostamento nel Junk del server): c'è la colonna Junk, manca il punteggio e lo spostamento — il filtro che archivia invece c'è, dalla 0.10.0.
- PGP/S-MIME, JMAP, importazione da altri client, stampa, ortografia, personalità multiple: il motore li ha, la nostra interfaccia no.
- Elenco incrementale dal server: a ogni controllo il motore chiede gli UID degli ultimi keep messaggi (una richiesta sola, ma cresce con il numero). Scarica però solo i corpi che non ha già.
- Le stringhe sono in italiano nel QML: per Harbour servirebbe l'inglese con il
catalogo
.tsaccanto, e comunque le librerie incluse nel pacchetto escludono Harbour (distribuzione via OpenRepos/Gitea).
Come è fatto
engine/engine_entry.ad[s]— ilmaindell'originale esportato comegd_engine_run;engine/build_lib.shcostruiscelibgrumpydove.so(motore Ada + shim C/C++), applica la patch del log e la copia inengine/prebuilt/.src/enginecallbacks.cpp— fornisce al motoregd_run,gd_single_instance,gd_already_open; il ponte conserva le callback.src/enginebridge.*— le stesse callback diqt_shim.h, esposte alla QML come elenchi e chiamate: cartelle, righe, corpo, allegati, mittente, header, segna letto, sposta, scarica.qml/pages/— Cartelle, Messaggi, Lettura, Composizione, Account;qml/cover/la copertina.qml/js/linkify.jseqml/js/reply.js— la logica che vale la pena provare fuori dall'app (link e indirizzi di risposta), ES5 e testata con node.engine/prebuilt/— la libreria del motore e le 31 librerie che Sailfish non ha (libetpan, jansson, gnutls, curl, runtime Ada…). Si rigenerano conpython3 packaging/bundle_libs.py. Finiscono in/usr/share/harbour-grumpydove/lib, dove punta l'rpath del binario.
La sandbox di Sailfish
Avviata dal launcher, l'app gira dentro SailJail e non vede ~/Mail: la
prima versione sembrava funzionare solo perché l'istanza di prova era partita da
SSH, fuori dalla sandbox. Ora:
- il Maildir è
~/.local/share/harbour/grumpydove/Mail, indicato al motore conGRUMPYDOVE_MAIL; - il log è in
~/.local/share/harbour/grumpydove/log/grumpydove.log(GRUMPYDOVE_LOG, patch applicata daengine/build_lib.sh); HOMEnon viene toccata: spostarla faceva perdere il tema del telefono e l'app restava azzurra.
Costruire e installare
export PATH=$HOME/SailfishOS/bin:$PATH
export XDG_RUNTIME_DIR=/run/user/47446
sfdk -c target=SailfishOS-5.1.0.11-aarch64 build -j4
L'RPM finisce in RPMS/. Le versioni pronte sono nelle
release;
sul telefono:
devel-su rpm -Uvh harbour-grumpydove-<versione>-1.aarch64.rpm
rm -rf ~/.cache/harbour-grumpydove*
Controlli
node tests/test_linkify.js # link: escape, punteggiatura, niente annidamenti
node tests/test_reply.js # indirizzi di risposta: dedupe, esclusione di se'
qmllint qml/pages/*.qml qml/cover/*.qml
Documenti
documenti/piano-porting.md— fattibilità, ostacoli, fasidocumenti/documento-funzionale.md— comportamento funzione per funzionedocumenti/comparazione-originale.md— cosa manca rispetto al client desktop, area per area
Licenza e provenienza
Il porting è EUPL-1.2, come l'originale di Uriel Fanelli.
Icone: l'icona dell'app e quelle delle cartelle vengono da icons/
dell'originale — le bitmap Eudora rilasciate dal Computer History Museum, BSD
3-Clause. Il testo è in icons/license/LICENSE ed è dichiarato nello spec del
pacchetto: la clausola BSD chiede che l'avviso di copyright accompagni la
redistribuzione, anche in forma binaria.