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

Chiarezza, leggibilità, manutenibilità, testabilità, sicurezza, prestazioni, conformità agli standard e ai requisiti del progetto. Il codice deve essere facile da capire per altri sviluppatori e per apportare modifiche in futuro.

Aspetti principali di un codice di qualità:

• Leggibilità: Uso di nomi significativi per variabili, funzioni e classi. Formattazione e indentazione corrette.
• Manutenibilità: Modularità, bassa coesione tra i componenti. Minima duplicazione del codice (DRY - Don't Repeat Yourself).
• Testabilità: Codice facilmente testabile automaticamente e manualmente. Presenza di test unitari e di integrazione.
• Sicurezza: Protezione da vulnerabilità (XSS, SQL Injection, ecc.). Validazione dei dati di input.
• Prestazioni: Uso efficiente delle risorse (memoria, CPU). Evitare i "colli di bottiglia".
• Conformità agli standard: Seguire gli standard di codifica accettati nel team o nell'industria.
• Documentazione: Commenti sul codice complesso, documentazione API (se applicabile).

Esempio di codice pulito e leggibile:

# Funzione per calcolare l'area di un rettangolo
def calculate_rectangle_area(width, height):
    # Verifica che i dati di input siano positivi
    if width <= 0 or height <= 0:
        raise ValueError("La larghezza e l'altezza devono essere numeri positivi")
    return width * height

# Uso della funzione
rectangle_width = 10
rectangle_height = 5
area = calculate_rectangle_area(rectangle_width, rectangle_height)
print(f"Area del rettangolo: {area}")

Esempio di codice meno pulito:

def calc_area(w, h): # Nomi abbreviati e poco chiari
    if w <= 0 or h <= 0: # Nessun controllo sul tipo di dato
        raise ValueError("Input must be positive") # Messaggio di errore poco informativo
    return w*h

La differenza tra i due esempi dimostra l'importanza di nominare correttamente, della leggibilità e della gestione degli errori per la qualità del codice.