En el següent article anem a fer una ullada a Cloc. Si treballes com a desenvolupador, és possible que hagis de compartir el teu progrés i les estadístiques del teu codi amb el cap o els companys. Per aquests casos, personalment conec pocs programes disponibles per a analitzar el codi font. Un d'aquests programes és 'Cloc'.
Utilitzant Cloc, podrem comptar fàcilment les línies de codi de diferents llenguatges de programació. Compte les línies en blanc, les línies de comentaris i les línies de el codi font. A la fin ens mostra el resultat en un format ordenat de columnes. Cloc és una utilitat gratuïta, de codi obert i multiplataforma completament escrita en el llenguatge de programació Perl.
Característiques generals de Cloc
Cloc ens ofereix diferents característiques per a un programa d'aquest estil. Entre elles s'inclouen les següents:
- Es fàcil d'instal·lar i utilitzar. No requereix dependències.
- Es tracta d'un programa de codi obert i multiplataforma.
- Anem a poder produir resultats en diversos tipus de formats, com ara; text sense format, SQL, JSON, XML, YAML o valors separats per comes.
- Ens ofereix possibilitats de ús amb git.
- També podrem comptar el codi en directoris i subdirectoris.
- Es pot utilitzar també amb arxius comprimits com tar, arxius Zip, arxius .ear de Java, Etc
Instal·lació d'Cloc
la utilitat Cloc està disponible en els repositoris per defecte de la majoria dels sistemes operatius similars a Unix. Per tant, podem instal·lar-lo utilitzant l'administrador de paquets per defecte a Debian i Ubuntu, com es mostra a continuació. Només cal obrir una terminal (Ctrl + Alt + T) i escriure:
sudo apt install cloc
També es pot instal·lar utilitzant un gestor de paquets de tercers com NPM.
npm install -g cloc
Compte les línies de el codi font
Per veure com funciona, anem a fer una ullada a un exemple simple. Tinc un programa, el típic 'hola món'Escrit en C. A continuació us mostro el codi que conté l'únic arxiu:
Per a la comptar les línies de codi en el programa hola.c, Simplement executa:
cloc hola.c
- La primera columna ens mostrarà el nom dels llenguatges de programació dels quals es compon el codi font. Com es pot veure a la sortida anterior, el codi font de el programa està escrit en el llenguatge de programació C.
- A la segona columna veurem el nombre d'arxius en cada llenguatge de programació. Per a aquest exemple, va mostrar 1 per que és el nombre d'arxius que conté el codi.
- La tercera columna mostra el nombre total de línies en blanc. Tenim zero línies en blanc en el nostre codi d'exemple.
- En la quarta columna veurem el nombre de línies de comentaris.
- I la última i cinquena columna mostra les línies totals, sense incloure comentaris, de el codi font donat.
Comptar les línies d'arxius comprimits, de el contingut d'un directori i subdirectoris
L'exemple és només un programa amb només set línies de codi, de manera que comptar les línies en el codi no és un gran problema. En cas que ens interessi explicar coses més grans, fes un cop d'ull a el següent exemple:
cloc archivo.zip
Segons la sortida anterior, Cloc ens va a mostrar el resultat d'un arxiu comprimit en segons, amb un agradable format de columna. Podem veure el total brut de cada secció a la fin, la qual cosa és molt útil quan es tracta d'analitzar el codi font d'un programa.
Cloc no només compta els arxius de codi font individuals, sinó que també els fitxers dins de directoris i subdirectoris, etc.
Compte les línies de codi dels arxius continguts en un directori:
cloc dir/
Si necessitem comptar les línies de codi dels arxius situats dins d'un Subdirectori, escriurem:
cloc dir/sub/directorio
Ajuda d'cloc
Cloc pot reconèixer diversos llenguatges de programació. Per veure la llista completa de llenguatges reconeguts, Executa:
cloc --show-lang
Si vols saber més sobre cloc, consulta la secció d'ajuda escrivint a la terminal (Ctrl + Alt + T):
cloc --help
Qui vulgui, podrà consultar més informació sobre aquesta aplicació en el seu repositori de GitHub.