Uno script Python che mette in ordine la sua lista contatti: un unico formato per nomi, telefoni ed email, e niente duplicati

Esempio di risultato

python merge_sales.py --month 2026-10

2026-11-02 09:14:03 INFO  Cartella: sales/2026-10, 9 file trovati
2026-11-02 09:14:03 INFO  shop-01.csv: 1.284 righe
2026-11-02 09:14:04 INFO  shop-02.xlsx: 967 righe
2026-11-02 09:14:04 WARN  shop-07.csv: saltate 3 righe senza prezzo (righe 88, 412, 913)
2026-11-02 09:14:05 INFO  Fatto: 10.412 righe -> report-2026-10.xlsx (fogli "Vendite" e "Totali")

[columns]
date = Data, Data vendita, Giorno
product = Prodotto, Articolo, Descrizione
quantity = Q.tà, Quantità, Pz
price = Prezzo, Prezzo unitario

def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
    """Legge il file di un negozio e gli dà i nomi di colonna del report."""
    table = pd.read_excel(path) if path.suffix == ".xlsx" else pd.read_csv(path, encoding="utf-8-sig")
    renamed = {}
    for name, variants in columns.items():
        found = next((c for c in table.columns if c.strip() in variants), None)
        if found is None:
            raise ReportError(f"{path.name}: nessuna colonna per '{name}' (cercate: {', '.join(variants)})")
        renamed[found] = name
    table = table.rename(columns=renamed)[list(columns)]
    table["shop"] = path.stem
    return table

Informazioni sul servizio

Una lista contatti raccolta negli anni da un negozio, un CRM e vari fogli di calcolo finisce per avere la stessa persona tre volte, telefoni scritti in cinque modi ed email con spazi o refusi. Questo script Python pulisce la sua lista sul suo computer: toglie gli spazi, corregge le maiuscole, scrive i numeri di telefono in un unico formato, segnala le email scritte in modo errato e trova i duplicati per email o telefono, poi salva un file pulito e un file separato con ciò che ha rimosso, così può controllarlo. Ci invii qualche riga con nomi, telefoni ed email inventati ma simili ai suoi, e le sue regole. La lista non arriva mai a noi, e lo script non invia mai nulla da nessuna parte. Verifica la forma di un indirizzo, non se la casella esiste.

Cosa è incluso

• Cosa riceveUn archivio ZIP con lo script Python, un README con le istruzioni passo passo e, dallo Standard, un file di impostazioni con le sue regole di pulizia; il codice è visibile anche nella pagina dell'ordine.
• Duplicati trovatiPer email, per telefono o per entrambi
• Un unico formato di telefonoCon il prefisso internazionale che imposta per i numeri che ne sono privi
• Righe rimosse conservateUn file separato con ogni riga rimossa o unita
• Resta sul suo computerLa sua lista non viene mai caricata né inviata
• Codice leggibileCon commenti, facile cambiare una regola in seguito

Come funziona

1. 1
   RegoleLei invia righe di esempio inventate e le sue regole per i duplicati
2. 2
   CodiceScriviamo lo script e la guida per eseguirlo
3. 3
   Lo proviLo esegue su una copia della lista e controlla le righe rimosse
4. 4
   ModificheChiede modifiche nei limiti del pacchetto e invia eventuali messaggi di errore

Cosa ci serve da lei

I nomi delle colonne della sua lista e 10-20 righe con nomi, telefoni ed email inventati, scritti come compaiono nei suoi dati reali (con lo stesso tipo di disordine). Le sue regole: cosa conta come duplicato, quale riga tenere (la più recente, la più completa), il prefisso internazionale per i numeri locali e come scrivere i telefoni. CSV o Excel, e il suo sistema: Windows, macOS o Linux. Non invii mai la lista reale.

Le chiederemo:

• Da dove viene la lista?
• Cosa conta come duplicato?
• Quale riga deve restare?
• Come devono essere i telefoni?

Confronto dei pacchetti

Domande e risposte

Non hai trovato la risposta? Chiedi a noi