Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
ce0f9bfa66 | ||
|
|
7bfaf63097 | ||
|
|
1b792f5b0a |
No files matched your search
@@ -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.
|
||||
@@ -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) {
|
||||
|
||||
@@ -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
|
||||
});
|
||||
|
||||
@@ -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
@@ -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);
|
||||
|
||||
@@ -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
@@ -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
|
||||
|
||||
Reference in new issue
Block a user