# Linux / macOS
chmod +x mboxshell-*
sudo mv mboxshell-* /usr/local/bin/mboxshell

# Oppure posizionalo in una directory locale dell'utente
mv mboxshell-* ~/.local/bin/mboxshell

# Clona e compila
git clone https://github.com/dcarrero/mboxshell.git
cd mboxshell
cargo build --release

# Il binario si trova in target/release/mboxshell
# Installalo a livello di sistema:
sudo cp target/release/mboxshell /usr/local/bin/

# Oppure solo per l'utente corrente:
cp target/release/mboxshell ~/.local/bin/

# Aggiungi la piattaforma che ti serve
rustup target add aarch64-apple-darwin      # macOS Apple Silicon
rustup target add x86_64-unknown-linux-gnu  # Linux x86_64
rustup target add aarch64-unknown-linux-gnu # Linux ARM64

# Compila per una piattaforma specifica
cargo build --release --target aarch64-apple-darwin

cargo install --git https://github.com/dcarrero/mboxshell.git

# Apri un file MBOX nell'interfaccia terminale
mboxshell mail.mbox

# Indicizza e mostra le statistiche
mboxshell index mail.mbox
mboxshell stats mail.mbox

# Cerca dalla riga di comando
mboxshell search mail.mbox "from:[email protected] date:2024"
mboxshell search mail.mbox "has:attachment subject:invoice" --json

# Esporta messaggi
mboxshell export mail.mbox --format eml --output ./emails/
mboxshell export mail.mbox --format csv --output summary.csv

# Estrai allegati
mboxshell attachments mail.mbox --output ./attachments/

# Unisci più file MBOX (i duplicati vengono rimossi per impostazione predefinita)
mboxshell merge file1.mbox file2.mbox -o merged.mbox

# Unisci etichettando ogni messaggio con la mailbox di provenienza
mboxshell merge Inbox.mbox Sent.mbox -o merged.mbox --source-header

# Genera le completions per la shell
mboxshell completions bash > /etc/bash_completion.d/mboxshell
mboxshell completions zsh > ~/.zfunc/_mboxshell
mboxshell completions fish > ~/.config/fish/completions/mboxshell.fish

from:[email protected]              Cerca per mittente
to:[email protected]          Cerca per destinatario
cc:[email protected]               Cerca per destinatario in Cc
subject:invoice                   Cerca nella riga dell'oggetto
body:important text               Cerca nel corpo del messaggio (full-text)
filename:report.pdf               Cerca per nome del file allegato
id:<message-id@domain>            Cerca per Message-ID
has:attachment                    Solo messaggi con allegati
has:no-attachment                 Solo messaggi senza allegati
label:Inbox                       Filtra per etichetta Gmail
date:2024-01                      Messaggi di gennaio 2024
date:2024-01-01..2024-06-30       Intervallo di date
before:2024-06-01                 Prima di una data
after:2024-01-01                  Dopo una data
size:>1mb                         Messaggi più grandi di 1 MB
-subject:spam                     Escludi messaggi con "spam" nell'oggetto
"exact phrase"                    Cerca una frase esatta
from:john subject:budget          AND implicito (entrambi devono corrispondere)
term1 OR term2                    OR esplicito

[general]
default_sort = "date"
sort_order = "desc"
date_format = "%Y-%m-%d %H:%M"
log_level = "warn"

[display]
theme = "dark"
layout = "horizontal"
show_sidebar = false
max_cached_messages = 50

[export]
default_format = "eml"
csv_separator = ","

src/
+-- main.rs              # CLI con clap
+-- lib.rs               # Re-export dei moduli
+-- error.rs             # Tipi di errore con thiserror
+-- config.rs            # Configurazione TOML
+-- mailbox_naming.rs    # Nomi mailbox leggibili (pacchetti Apple Mail)
+-- i18n/                # Internazionalizzazione (EN/ES)
+-- parser/
|   +-- mbox.rs          # Parser in streaming (non carica mai il file in memoria)
|   +-- eml.rs           # Parser per singoli file EML
|   +-- mime.rs          # Decodifica MIME, multipart, charset
|   +-- header.rs        # Header RFC 5322, encoded-word RFC 2047
+-- index/
|   +-- builder.rs       # Costruzione dell'indice binario
|   +-- reader.rs        # Query sull'indice
|   +-- format.rs        # Formato binario con verifica di integrità SHA-256
+-- model/
|   +-- mail.rs          # MailEntry, MailBody
|   +-- attachment.rs    # Metadati degli allegati
|   +-- address.rs       # Parsing degli indirizzi RFC 5322
+-- store/
|   +-- reader.rs        # Lettura basata su offset con cache LRU
+-- search/
|   +-- query.rs         # Parser delle query di ricerca
|   +-- metadata.rs      # Ricerca veloce sull'indice (O(n), < 200ms per 1M messaggi)
|   +-- fulltext.rs      # Ricerca full-text in streaming
+-- export/
|   +-- eml.rs           # Esportazione in .eml
|   +-- csv.rs           # Esportazione del riepilogo in CSV (BOM UTF-8)
|   +-- text.rs          # Esportazione in testo semplice
|   +-- attachment.rs    # Estrazione degli allegati
|   +-- mbox.rs          # Merge MBOX con deduplicazione e header di origine
+-- tui/
    +-- app.rs           # Stato globale (Elm Architecture)
    +-- event.rs         # Gestione degli eventi da tastiera
    +-- ui.rs            # Layout e dispatch del rendering
    +-- threading.rs     # Algoritmo JWZ per i thread di conversazione
    +-- theme.rs         # Tema dei colori
    +-- widgets/         # Componenti visivi
        +-- mail_list.rs       # Lista con scorrimento virtuale
        +-- mail_view.rs       # Visualizzatore messaggi con scorrimento
        +-- sidebar.rs         # Pannello etichette/cartelle
        +-- header_bar.rs      # Barra superiore
        +-- status_bar.rs      # Barra di stato
        +-- search_bar.rs      # Barra di ricerca
        +-- search_popup.rs    # Popup dei filtri di ricerca
        +-- help_popup.rs      # Popup di aiuto
        +-- attachment_popup.rs # Popup degli allegati
        +-- export_popup.rs     # Popup di esportazione