cloc - Broj redova koda u mnogim programskim jezicima

Dok radite na različitim projektima, ponekad se od vas može tražiti da dostavite izvještaj ili statistiku vašeg napretka, ili jednostavno da izračunate vrijednost vašeg koda.

Postoji ovaj jednostavan, ali moćan alat pod nazivom “cloc – broj redova koda” koji vam omogućava da prebrojite sav broj vašeg koda i istovremeno isključite komentare i prazne redove.

Dostupan je u svim glavnim distribucijama Linuxa i podržava više programskih jezika i ekstenzija datoteka i nema nikakve posebne zahtjeve za korištenje.

U ovom vodiču ćete naučiti kako da instalirate i koristite cloc na vašem Linux sistemu.

Kako instalirati i koristiti Cloc u Linux sistemima

Instalacija cloca je laka i jednostavna. U nastavku možete vidjeti kako instalirati cloc u različitim operativnim sistemima sa njihovim povezanim menadžerima paketa:

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 se može koristiti za brojanje redova u određenoj datoteci ili u više datoteka unutar direktorija. Da biste koristili cloc jednostavno upišite cloc nakon čega slijedi datoteka ili direktorij koji želite pregledati.

Evo primjera iz datoteke u bash-u. Datoteka o kojoj je riječ sadrži sljedeći kod u bash-u:

cat bash_script.sh

Sada pokrenimo cloc na njemu.

cloc bash_script.sh

Kao što vidite, brojao je broj fajlova, praznih redova, komentara i redova koda.

Još jedna cool karakteristika cloc je da se čak može koristiti i na komprimiranim datotekama. Na primjer, preuzeo sam najnoviju WordPress arhivu i pokrenuo cloc na njoj.

cloc latest.tar.gz

Evo rezultata:

Možete vidjeti da prepoznaje različite tipove koda i odvaja statistiku po jeziku.

U slučaju da trebate dobiti izvještaj za više datoteka u direktoriju, možete koristiti opciju “--by-file ”, koja će brojati redove u svakoj datoteci i dati izvještaj za njih. Ovo može potrajati za projekte sa mnogo datoteka i hiljadama linija koda.

Sintaksa je sljedeća:

cloc --by-file <directory>

Iako je pomoć cloc lako čitljiva i razumljiva, uključit ću neke od dodatnih opcija koje se mogu koristiti sa cloc nekim korisnicima mogu biti korisne.

  • --diff – izračunava razlike u kodu između izvornih datoteka set1 i set2. Ulaz može biti mješavina datoteka i direktorija.
  • --git – prisiljava ulaze da se prepoznaju kao git ciljevi ako isti prvo nisu identificirani kao nazivi datoteka ili direktorija.
  • --ignore-whitespace – zanemaruje horizontalni razmak prilikom upoređivanja datoteka sa --diff.
  • --max-file-size= – ako želite da preskočite datoteke veće od datog iznosa MB.
  • --exclude-dir=, – isključiti date direktorije odvojene zarezima.
  • --exclude-ext=, – isključiti date ekstenzije datoteke.
  • --csv – izvoz rezultata u CSV format datoteke.
  • --csv-delimiter= – koristite znak kao graničnik.
  • --out= – sačuvajte rezultate u <file>.
  • --tiho – potisnuti sve informativne poruke i prikazati samo konačni izvještaj.
  • --sql= – zapišite rezultate kao naredbe kreiranja i umetanja koje može pročitati program baze podataka kao što je SQLite.
Zaključak

Cloc je mali koristan uslužni program koji je svakako dobro imati u svom arsenalu. Iako se možda ne koristi na dnevnoj bazi, može vam pomoći kada morate generirati izvješće ili ako vas samo zanima kako napreduje vaš projekt.