Mente, scrittura e felicità

Cosa sapete della manutenibilità?

Le statistiche dimostrano che gli sviluppatori che lavorano con un codice più pulito si sentono in condizioni di lavoro migliori, sono più felici e di conseguenza producono di più. Questo ci porta direttamente al concetto di codice pulito.

L’arte di lavorare su un progetto creato con tecniche agili garantisce la qualità del codice e porta direttamente alla manutenibilità.

Ma cos’è esattamente il codice pulito?

Partendo dall’inizio, il termine è stato nominato da Robert Cecil Martin nel 2008, nel suo libro “Clean Code: A Handbook of Agile Software Craftsmanship”. Il predecessore, autore e forza trainante del Manifesto Agile, è noto per aver sviluppato diversi principi di progettazione del software. È stato lui a individuare che il problema principale nello sviluppo del software era il codice e, di conseguenza, a stabilire tecniche per migliorare e programmare i progetti.

Per i programmatori, creare codice pulito è come un’opera d’arte. Alcuni autori specializzati nel settore lo descrivono in questo modo:

Dice Grady Booch, autore di “Object Oriented Analysis and Design with Applications”: Il codice pulito è semplice e diretto, si legge come un testo ben scritto e non nasconde l’intento del progettista, ma mostra chiare astrazioni e linee di controllo.

Ha detto Dave Thomas, fondatore di OTI, il padrino della strategia Eclipse: il codice pulito può essere letto e migliorato da un programmatore diverso dal suo autore originale. Ha test unitari e di accettazione. Ha nomi significativi. Offre un solo modo di fare qualcosa, non diversi. Ha dipendenze minime, è definito in modo esplicito e offre APPI chiari e minimi. Il codice deve essere alfabetizzato in termini di linguaggio, poiché non tutte le informazioni possono essere espresse chiaramente nel codice.

Uno sguardo ai principi del codice pulito, enunciati da Martin

BSiate eleganti con il codice per evitare un lavoro più arduo e costoso. La semplicità e il minimalismo sono immersi anche nella programmazione, con gli stessi effetti della vita. Meno uno spazio è ingombro, meno energia il nostro corpo vi spenderà; lo stesso accade con il nostro progetto: se è meno ingombro, più facile sarà lavorarci e più ci sentiremo a nostro agio.

Usate il buon senso quando assegnate i nomi. Scegliere nomi che siano associati all’azione che indicano e che siano leggibili faciliterà i programmatori che dovranno lavorare sullo stesso progetto in futuro.

Riducete al massimo le dimensioni di ogni funzione e fate in modo che svolga un’unica funzione, cioè separate le funzioni per ogni azione che volete programmare.

E soprattutto, i commenti che fate devono essere di qualità, necessari e corretti. “La verità può essere trovata solo in un posto: il codice.”

“La verità può essere trovata solo in un posto: il codice.”

Quali strumenti possono aiutarvi?

Un buon programmatore dovrebbe lavorare con SonarQube (on-premise) o SonarCloud (as a service), uno strumento che consente di lavorare sulla qualità del codice identificando gate di qualità, affidabilità, sicurezza, manutenibilità, copertura, duplicazioni,

È importante visualizzare la qualità del codice per migliorarla e mantenerla.

Overview Report for SonarQube o SonarCloud può fornire un report su una singola pagina con metriche aggregate. Include inoltre il supporto per l’inglese e lo spagnolo, l’accesso a tutte le lingue e tecnologie di SonarCloud e la personalizzazione del logo nel footer.

Se volete avvicinarvi alla programmazione, vi consigliamo di leggere: “Clean Code: A Handbook of Agile Software Craftsmanship”.

---

bitegarden team

Helping companies to develop better software