Compare commits

..
3 Commits
Author SHA1 Message Date
Carlo Baratto ce0f9bfa66 Letto e' uno spazio, non vuoto; Sent non si marca (0.5.4)
Status_Of del motore restituisce 'U' per il non letto e ' ' per il letto: il
confronto con la stringa vuota rendeva non letto qualunque messaggio.
2026-11-11 15:25:32 +01:00
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
7 changed files with 164 additions and 63 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.
+9
View File
@@ -40,6 +40,15 @@ 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), tranne nelle
// cartelle di uscita: quello che abbiamo scritto noi si legge sempre
// in tondo, non e' posta da leggere.
var tipo = engine.folderType(page.cartella);
if (tipo !== "out" && tipo !== "draft"
&& engine.isUnread(page.cartella, page.riga)) {
engine.markRead(page.cartella, page.riga, true);
}
}
function salvaAllegato(indice) {
+5 -1
View File
@@ -24,6 +24,10 @@ Page {
messaggi.clear();
if (page.cartella < 0) return;
var elenco = engine.messages(page.cartella);
// Nelle cartelle di uscita niente grassetto: e' posta nostra, non
// posta da leggere.
var tipo = engine.folderType(page.cartella);
var senzaNonLetti = (tipo === "out" || tipo === "draft");
for (var i = 0; i < elenco.length; i++) {
var m = elenco[i];
if (page.soloNonLetti && !m.nonLetto) continue;
@@ -32,7 +36,7 @@ Page {
mittente: m.mittente,
oggetto: m.oggetto,
data: m.data,
nonLetto: m.nonLetto,
nonLetto: senzaNonLetti ? false : m.nonLetto,
junk: m.junk,
allegato: m.allegato
});
+11 -1
View File
@@ -1,6 +1,6 @@
Name: harbour-grumpydove
Summary: Eudora-style mail interface, mobile prototype
Version: 0.5.2
Version: 0.5.4
Release: 1
Group: Qt/Qt
# Codice EUPL-1.2; le icone vengono dagli sprite di Eudora, BSD 3-Clause
@@ -27,6 +27,16 @@ 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.4-1
- "Letto" era considerato "stato vuoto": il motore scrive invece uno spazio
(U = non letto, ' ' = letto, piu' Q/D/Z/S/R/F). Il confronto con "" rendeva
non letto qualunque messaggio, anche in Sent
- Nelle cartelle di uscita (Sent/Out) niente grassetto e nessuna marcatura:
e' posta nostra
* 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"
+30 -1
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
@@ -312,6 +316,31 @@ QVariantList EngineBridge::folders()
return out;
}
// La colonna Status non e' vuota quando il messaggio e' letto: e' uno spazio
// (vedi Mail_Boxes.Status_Of, che da' U per il non letto e ' ' per il resto,
// con Q/D/Z/S/R/F per gli altri casi). Confrontare con "" rendeva non letto
// qualunque messaggio.
static bool unreadMark(const QString &stato)
{
return stato.trimmed() == QLatin1String("U");
}
bool EngineBridge::isUnread(int folder, int row)
{
return unreadMark(cell(folder, row, Status));
}
QString EngineBridge::folderType(int folder)
{
const QVariantList elenco = folders();
for (int i = 0; i < elenco.size(); i++) {
const QVariantMap m = elenco.at(i).toMap();
if (m.value("folder").toInt() == folder)
return m.value("tipo").toString();
}
return QString();
}
// Legge una cartella dal motore una volta sola e la tiene: una chiamata per
// campo per riga, quindi rileggerla a ogni apertura era il costo vero.
void EngineBridge::buildRows(int folder)
@@ -339,7 +368,7 @@ void EngineBridge::buildRows(int folder)
r.oggetto = subject;
r.data = cell(folder, row, Date);
r.dimensione = cell(folder, row, Size);
r.nonLetto = !cell(folder, row, Status).isEmpty();
r.nonLetto = unreadMark(cell(folder, row, Status));
r.allegato = !cell(folder, row, Attachment).isEmpty();
r.junk = !cell(folder, row, Junk).isEmpty();
rows.append(r);
+3
View File
@@ -57,6 +57,9 @@ public:
// Per rispondere serve l'indirizzo, non solo il nome che sta in colonna.
Q_INVOKABLE QString senderOf(int folder, int row);
Q_INVOKABLE QString headerOf(int folder, int row, const QString &name);
// "non letto" non e' "stato vuoto": la regola sta in un posto solo.
Q_INVOKABLE bool isUnread(int folder, int row);
Q_INVOKABLE QString folderType(int folder);
signals:
void ready();
+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.4"));
qDebug() << "harbour-grumpydove v0.5.2 build" << __DATE__ << __TIME__;
qDebug() << "harbour-grumpydove v0.5.4 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