Cosa significa, secondo voi, scrivere codice di qualità?

Codice di qualità:

• Leggibile e comprensibile: Facile da percepire da altri sviluppatori (e da te in futuro).
• Manutenibile: Facile da modificare, correggere errori e aggiungere nuove funzionalità.
• Affidabile: Funziona correttamente e in modo prevedibile in diverse condizioni.
• Efficiente: Ha prestazioni accettabili e utilizza le risorse in modo ottimale.
• Testabile: È facile scrivere test automatizzati per verificarne la funzionalità.
• Conforme agli standard: Segue le convenzioni di stile di codice e i principi architetturali adottati.
• Documentato (se necessario): Le decisioni chiave e le parti complesse del codice sono spiegate.

Esempi di aspetti di codice di qualità:

• Nomenclatura: Uso di nomi significativi per variabili, funzioni e classi.
• Struttura: Divisione logica del codice in moduli, funzioni e classi.
• Assenza di duplicazioni: Evitare di ripetere lo stesso codice.
• Gestione degli errori: Risposta appropriata alle situazioni eccezionali.

# Esempio di codice leggibile e pulito
def calculate_order_total(items):
    """
    Calcola il costo totale degli articoli in un ordine.
    """
    total_price = 0
    for item in items:
        total_price += item.price * item.quantity
    return total_price

# Esempio di codice di qualità inferiore (nomi poco chiari, nessun commento)
def calc(a):
    t = 0
    for b in a:
        t += b[0] * b[1]
    return t

Tabella comparativa:

Aspetto	Codice di qualità	Codice di bassa qualità
Leggibilità	Facile da leggere e capire	Difficile da capire
Manutenibilità	Facile da modificare e migliorare	Difficile apportare modifiche
Testabilità	Facile scrivere test automatizzati	Difficile automatizzare i test