cloc - Numără linii de cod în multe limbaje de programare

În timp ce lucrați la diferite proiecte, uneori vi se poate cere să furnizați un raport sau statistici ale progresului dvs. sau pur și simplu să calculați valoarea codului dvs.

Există acest instrument simplu, dar puternic, numit „cloc – count lines of code ” care vă permite să numărați tot numărul codului și să excludeți comentariile și liniile goale în același timp.

Este disponibil în toate distribuțiile majore de Linux și acceptă mai multe limbaje de programare și extensii de fișiere și nu are cerințe specifice pentru a fi utilizat.

În acest tutorial veți învăța cum să instalați și să utilizați cloc pe sistemul dvs. Linux.

Cum se instalează și se utilizează Cloc în sistemele Linux

Instalarea cloc este ușoară și simplă. Mai jos puteți vedea cum să instalați cloc în diferite sisteme de operare cu managerii de pachete aferente acestora:

sudo apt install cloc                  # Debian, Ubuntu
sudo yum install cloc                  # Red Hat, Fedora
sudo dnf install cloc                  # Fedora 22 or later
sudo pacman -S cloc                    # Arch
sudo emerge -av dev-util/cloc          # Gentoo https://packages.gentoo.org/packages/dev-util/cloc
sudo apk add cloc                      # Alpine Linux
sudo pkg install cloc                  # FreeBSD
sudo port install cloc                 # Mac OS X with MacPorts
brew install cloc                      # Mac OS X with Homebrew
npm install -g cloc                    # https://www.npmjs.com/package/cloc

Cloc poate fi folosit pentru a număra liniile dintr-un anumit fișier sau din mai multe fișiere din director. Pentru a utiliza cloc pur și simplu tastați cloc urmat de fișierul sau directorul pe care doriți să îl examinați.

Iată un exemplu dintr-un fișier în bash. Fișierul în cauză conține următorul cod în bash:

cat bash_script.sh

Acum hai să rulăm cloc pe el.

cloc bash_script.sh

După cum puteți vedea, a numărat numărul de fișiere, linii goale, comentarii și linii de cod.

O altă caracteristică interesantă a cloc este că poate fi folosită chiar și pe fișiere comprimate. De exemplu, am descărcat cea mai recentă arhivă WordPress și am rulat cloc pe ea.

cloc latest.tar.gz

Iată rezultatul:

Puteți vedea că recunoaște diferitele tipuri de cod și separă statisticile pe limbă.

În cazul în care trebuie să obțineți un raport pentru mai multe fișiere dintr-un director, puteți utiliza opțiunea „--by-file ”, care va număra liniile din fiecare fișier și va oferi un raport pentru ele. Acest lucru poate dura ceva timp pentru proiecte cu multe fișiere și mii de linii de cod.

Sintaxa este următoarea:

cloc --by-file <directory>

În timp ce ajutorul cloc este ușor de citit și de înțeles, voi include câteva dintre opțiunile suplimentare care pot fi folosite cu cloc pe care unii utilizatori le pot găsi utile.

--diff – calculează diferențele de cod între fișierele sursă ale set1 și set2. Intrarea poate fi un amestec de fișiere și directoare.
--git – forțează ca intrările să fie recunoscute ca ținte git dacă aceleași nu sunt mai întâi identificate ca nume de fișiere sau de director.
--ignore-whitespace – ignoră spațiul alb orizontal atunci când compară fișierele cu --diff.
--max-file-size= – dacă doriți să omiteți fișierele mai mari decât cantitatea dată MB.
--exclude-dir=, – excludeți directoarele date separate prin virgulă.
--exclude-ext=, – excludeți extensiile de fișiere date.
--csv – exportați rezultatele în format de fișier CSV.
--csv-delimiter= – utilizați caracterul ca delimitator.
--out= – salvați rezultatele în <file>.
--quiet – suprimă toate mesajele informative și arată doar raportul final.
--sql= – scrieți rezultatele ca instrucțiuni create și inserați care pot fi citite de un program de bază de date precum SQLite.

Concluzie

Cloc este un mic utilitar util pe care cu siguranță este bine să îl ai în arsenalul tău. Deși este posibil să nu fie folosit zilnic, vă poate ajuta atunci când trebuie să generați un raport sau dacă sunteți doar curios cum merge proiectul dvs.