|
|
|
@@ -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.
|