Compare commits

...
2 Commits
Author SHA1 Message Date
Carlo Baratto 7bfaf63097 Aprire un messaggio lo segna letto (0.5.3) 2026-11-11 15:19:28 +01:00
Carlo Baratto 1b792f5b0a README: stato a 0.5.2 e ringraziamento a Uriel Fanelli
Il README parlava ancora del prototipo con dati finti. Ora dice cosa funziona
davvero, cosa manca (invio, HTML, ricerca), com'e' fatto il ponte e perche' la
posta vive nella cartella dati dell'app.
2026-11-11 15:11:00 +01:00
5 changed files with 122 additions and 61 deletions

No files matched your search

+104 -58
View File
@@ -1,58 +1,101 @@
# harbour-grumpydove — prototipo dell'interfaccia
# harbour-grumpydove — GrumpyDove su Sailfish OS
Schermate Sailfish (Silica/QML) per il porting di **GrumpyDove**, il client
mail in stile Eudora di LowEel (Ada + Qt 6, licenza EUPL-1.2):
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>
Questo pacchetto **non è il client**: è la sola interfaccia, con dati finti in
`qml/js/dati.js`, e serve a decidere se e come portare il motore. Non fa rete, non
legge la posta, non manda nulla.
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.
## Perché esiste
## Grazie
Il porting ha un ostacolo tecnico che non si vede dalle schermate (toolchain Ada
su ARM e tre librerie assenti dai repo Sailfish: libetpan, gpgme, jansson — vedi
`documenti/piano-porting.md`). Prima di spendere settimane su quello conviene
sapere se l'interfaccia mobile regge, perché è la parte che si può buttare via
senza rimpianti se il disegno non funziona.
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.
## Documenti
Il progetto originale è EUPL-1.2; anche questo porting resta EUPL-1.2.
- `documenti/piano-porting.md` — fattibilità, ostacoli, fasi, stime
- `documenti/documento-funzionale.md` — cosa fa l'app e come si comporta su mobile, funzione per funzione
## Stato: 0.5.2
## Le schermate
Installabile e usabile per leggere la posta. L'invio **non** è ancora collegato.
- **Cartelle** — l'albero di Eudora appiattito in lista: account in cima,
cartelle rientrate per profondità, sottocartelle sotto. Non letti in grassetto,
numero a destra; Out e Trash non si marcano mai (regola di Eudora), Junk è
marcato senza sbilanciare l'account.
- **Messaggi** — mittente sopra (grassetto se non letto, barra colorata a
sinistra), oggetto sotto, data a destra. Niente tabelle a colonne: su un
telefono non ci stanno. Menù a tendina per scaricare la posta e filtrare i non
letti, menù dal basso per l'ordinamento.
- **Lettura** — intestazioni (Da / A / data), corpo in testo, posizione
«3 di 12». **Paginazione a tap**: tocco sul lato destro = messaggio
successivo, sinistro = precedente; il centro resta scorrevole.
- **Compose** — A, Oggetto, Testo; l'invio è finto e conferma a schermo.
- **Copertina** — non letti totali.
Funziona oggi:
## Il motore dentro l'app
- **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).
- **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**.
- **Rispondi** (con l'indirizzo vero del mittente, non solo il nome) e
**Rispondi a tutti** (mittente, destinatari e copie, senza te e senza
doppioni).
- **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).
Dalle 0.2.0 le schermate leggono la posta vera: il motore di GrumpyDove
(l'originale Ada + C) è compilato per aarch64 e collegato all'app.
## Cosa manca
- `engine/engine_entry.ad[s]` — il main dell'originale esportato come
`gd_engine_run`; `engine/build_lib.sh` produce `libgrumpydove.so`.
- `src/enginebridge.*` — il ponte: riceve le callback del motore (le stesse di
`qt_shim.h`) e le espone alla QML come elenchi; `src/enginecallbacks.cpp`
fornisce `gd_run`, `gd_single_instance`, `gd_already_open`.
- **Invio**: la pagina di composizione si compila ma non manda nulla. Serve
collegare `gd_compose_fn` e la coda di invio del motore.
- **HTML**: le mail arrivano come testo. L'originale ha una vista senza script
né stili remoti, con le immagini remote solo su richiesta — va portata.
- **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 `.ts` accanto, e comunque le librerie incluse nel pacchetto
escludono Harbour (distribuzione via OpenRepos/Gitea).
## Come è fatto
- `engine/engine_entry.ad[s]` — il `main` dell'originale esportato come
`gd_engine_run`; `engine/build_lib.sh` costruisce `libgrumpydove.so`
(motore Ada + shim C/C++), applica la patch del log e la copia in
`engine/prebuilt/`.
- `src/enginecallbacks.cpp` — fornisce al motore `gd_run`,
`gd_single_instance`, `gd_already_open`; il ponte conserva le callback.
- `src/enginebridge.*` — le stesse callback di `qt_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.js` e `qml/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 con
`python3 packaging/bundle_libs.py`, che riscrive anche `files.pri` (l'elenco
esplicito per qmake: un glob verrebbe espanso quando i file non ci sono
ancora). Sono nel pacchetto sotto `/usr/share/harbour-grumpydove/lib`, dove
punta l'rpath del binario.
`python3 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 con
`GRUMPYDOVE_MAIL`;
- il log è in `~/.local/share/harbour/grumpydove/log/grumpydove.log`
(`GRUMPYDOVE_LOG`, patch applicata da `engine/build_lib.sh`);
- `HOME` **non** viene toccata: spostarla faceva perdere il tema del telefono e
l'app restava azzurra.
## Costruire e installare
@@ -60,33 +103,36 @@ Dalle 0.2.0 le schermate leggono la posta vera: il motore di GrumpyDove
export PATH=$HOME/SailfishOS/bin:$PATH
export XDG_RUNTIME_DIR=/run/user/47446
sfdk -c target=SailfishOS-5.1.0.11-aarch64 build -j4
# RPM in RPMS/, poi sul telefono:
# scp RPMS/*/harbour-grumpydove-*.rpm defaultuser@<ip>:
# devel-su rpm -ivh harbour-grumpydove-*.rpm
```
L'RPM finisce in `RPMS/`. Le versioni pronte sono nelle
[release](https://git.hackatoniclife.com/kaneda/harbour-grumpydove/releases);
sul telefono:
```sh
devel-su rpm -Uvh harbour-grumpydove-<versione>-1.aarch64.rpm
rm -rf ~/.cache/harbour-grumpydove*
```
## Controlli
```sh
node tests/test_dati.js # ruoli e conteggi dei dati finti
qmllint qml/pages/*.qml qml/cover/*.qml # sintassi (Silica assente: filtrare i moduli mancanti)
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
```
## Debito noto (prima di ogni pubblicazione)
## Documenti
- Le stringhe sono in **italiano nel QML**. Per Harbour servono in inglese con il
catalogo `.ts` italiano accanto (`sailfishapp_i18n`), come negli altri progetti
dell'archivio.
- Il prototipo non ha impostazioni, né persistenza: i non letti si azzerano
riaprendo l'app.
- `documenti/piano-porting.md` — fattibilità, ostacoli, fasi
- `documenti/documento-funzionale.md` — comportamento funzione per funzione
## Licenza
## Licenza e provenienza
Le schermate sono lavoro nuovo, ma il progetto nasce da GrumpyDove (EUPL-1.2):
la licenza del porting resta la stessa.
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 della licenza è in `icons/license/LICENSE` e la provenienza
è dichiarata nello spec del pacchetto: la clausola BSD chiede che l'avviso di
copyright accompagni la redistribuzione, anche in forma binaria.
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.
+7
View File
@@ -40,6 +40,13 @@ Page {
// La colonna 4 e' solo il nome: per rispondere serve l'indirizzo vero.
page.indirizzo = engine.senderOf(page.cartella, page.riga);
page.totale = engine.messages(page.cartella).length;
// Aprire un messaggio lo segna letto (regola di Eudora). Si guarda
// prima: se era gia' letto non si riscrive nulla, cosi' leggi() puo'
// essere richiamata anche a ogni ready senza rifare il lavoro.
if (engine.cell(page.cartella, page.riga, 0) !== "") {
engine.markRead(page.cartella, page.riga, true);
}
}
function salvaAllegato(indice) {
+5 -1
View File
@@ -1,6 +1,6 @@
Name: harbour-grumpydove
Summary: Eudora-style mail interface, mobile prototype
Version: 0.5.2
Version: 0.5.3
Release: 1
Group: Qt/Qt
# Codice EUPL-1.2; le icone vengono dagli sprite di Eudora, BSD 3-Clause
@@ -27,6 +27,10 @@ Icons come from the original project's Eudora bitmaps (BSD 3-Clause,
Computer History Museum).
%changelog
* Wed Nov 11 2026 Carlo Baratto <carlo@carlobaratto.it> - 0.5.3-1
- Aprire un messaggio lo segna letto: nessuno lo faceva, c'era solo la voce di
menu per il contrario. La lista si aggiorna subito (ready emesso fuori dalla
chiamata, per non rientrare mentre una cella viene letta)
* Wed Nov 11 2026 Carlo Baratto <carlo@carlobaratto.it> - 0.5.2-1
- Rispondi prendeva un destinatario vuoto: ora legge l'indirizzo del mittente
dal motore (la colonna 4 e' solo il nome) e lo mette in "A"
+4
View File
@@ -168,6 +168,10 @@ void EngineBridge::markRead(int folder, int row, bool read)
s_read(folder, row, read ? 1 : 0);
if (s_commit) s_commit(folder);
dropRows(folder); // il grassetto del non letto è cambiato
// Le altre pagine (elenco, cartelle, copertina) mostrano lo stato: si
// avvisano fuori dalla chiamata, altrimenti chi legge la cella rientra
// qui dentro mentre la sta leggendo.
QTimer::singleShot(0, this, [this] { emit ready(); });
}
// La Trash dell'account della cartella: il motore lavora per numeri di
+2 -2
View File
@@ -24,9 +24,9 @@ Q_DECL_EXPORT int main(int argc, char *argv[])
app->setOrganizationName(QStringLiteral("harbour"));
app->setApplicationName(QStringLiteral("grumpydove"));
app->setApplicationVersion(QStringLiteral("0.5.2"));
app->setApplicationVersion(QStringLiteral("0.5.3"));
qDebug() << "harbour-grumpydove v0.5.2 build" << __DATE__ << __TIME__;
qDebug() << "harbour-grumpydove v0.5.3 build" << __DATE__ << __TIME__;
// La sandbox di Sailfish (SailJail) non lascia vedere ~/Mail, ma il motore
// legge il percorso del Maildir da GRUMPYDOVE_MAIL: si punta alla cartella