README: svuota cestino anche sul server, HTML ridotto a testo, cosa manca. documento funzionale: stato dell'implementazione, HTML deciso. piano di porting: tabella dello stato, patch al motore, trappole, controlli.
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.
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.8.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.
- 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 solo HTML: si mostra il testo (la parte
plaindel MIME e, se manca, l'HTML ridotto a testo leggibile). Niente motore web, niente contenuti remoti. - Rispondi (con l'indirizzo vero del mittente, non solo il nome) e Rispondi a tutti (mittente, destinatari e copie, senza te e senza doppioni).
- Invio: il messaggio entra nella coda del motore, parte con SMTP e la copia resta in Sent sul server. A, Cc, Oggetto, Testo; esiti a schermo.
- 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).
Cosa manca
- HTML vero: oggi si mostra il testo. L'originale ha una vista senza script né stili remoti, con le immagini remote solo su richiesta — portarla significherebbe un motore web dentro la pagina.
- Ricerca, filtri, PGP/S-MIME, rubrica CardDAV, JMAP: 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 funzione
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.