cloc – Հաշվել կոդի տողերը ծրագրավորման բազմաթիվ լեզուներով

Որպես ծրագրավորող, ծրագրային ապահովման նախագծի բարդությունն ու չափը չափելու հիմնական չափանիշներից մեկը կոդի տողերի քանակն է (LOC): LOC-ի հաշվումը հոգնեցուցիչ և ժամանակատար խնդիր է, որը հակված է սխալների, հատկապես խոշոր կոդերի բազաներում: Բարեբախտաբար, կա cloc կոչվող գործիք, որը կարող է ավտոմատացնել գործընթացը և ճշգրիտ և մանրամասն տեղեկատվություն տրամադրել ծրագրավորման բազմաթիվ լեզուներում կոդերի տողերի քանակի վերաբերյալ:

cloc-ը անվճար և բաց կոդով գործիք է, որը կարող է հաշվել կոդերի տողերը ավելի քան 200 ծրագրավորման լեզուներով: Այն հասանելի է Windows-ի, Linux-ի և macOS-ի համար և կարող է օգտագործվել հրամանի տողից կամ ինտեգրվել ձեր զարգացման աշխատանքային գործընթացին: Այս հոդվածում մենք կուսումնասիրենք cloc-ի առանձնահատկություններն ու հնարավորությունները, ինչպես նաև կներկայացնենք ձեռնարկ այն մասին, թե ինչպես օգտագործել այն՝ ձեր նախագծերում կոդի տողերը հաշվելու համար:

Ինչպես սկսել cloc-ով

Նախքան cloc-ի օգտագործման մանրամասների մեջ խորանալը, եկեք սկսենք տեղադրել այն մեր համակարգում: Cloc-ի տեղադրման գործընթացը տատանվում է՝ կախված ձեր օգտագործած օպերացիոն համակարգից: Առայժմ, եկեք տեսնենք, թե ինչպես տեղադրել այն Linux համակարգում:

Cloc-ի տեղադրում Linux-ում

Linux բաշխումների համար cloc-ը կարող է տեղադրվել փաթեթի կառավարչի միջոցով: Կախված բաշխումից, փաթեթի կառավարիչը կարող է հարմար լինել Debian/Ubuntu-ի համար, yum-ը CentOS/RHEL-ի համար կամ pacman-ը Arch Linux-ի համար: Cloc-ը տեղադրելու համար բացեք տերմինալի պատուհանը և գործարկեք հետևյալ հրամանը −

sudo apt-get install cloc

կամ

sudo yum install cloc

կամ

sudo pacman -S cloc

Եթե cloc-ը հասանելի չէ լռելյայն պահոցներում, կարող է անհրաժեշտ լինել ավելացնել լրացուցիչ պահեստ կամ ներբեռնել և տեղադրել փաթեթը ձեռքով:

Երբ դուք տեղադրեք cloc-ը, կարող եք սկսել օգտագործել այն՝ ձեր նախագծերում կոդի տողերը հաշվելու համար: Սկսելու համար բացեք տերմինալ կամ հրամանի տող և նավարկեք դեպի այն գրացուցակը, որը պարունակում է կոդը, որը ցանկանում եք վերլուծել: Այնուհետև գործարկեք հետևյալ հրամանը −

cloc .

Սա կհանձնարարի cloc-ին հաշվել ընթացիկ գրացուցակի և նրա բոլոր ենթագրքերում գտնվող կոդի տողերը: Լռելյայնորեն, cloc-ը կցուցադրի արդյունքները տերմինալում՝ կազմակերպված ըստ ծրագրավորման լեզվի: Օրինակ, ելքը կարող է նման լինել −

------------------------------------------------------------------------------- 
Language files blank comment code -------------------------------------------------
------------------------------ Python 21 416 710 1823 HTML 32 157 36 1437 CSS 9 59 
0 483 JavaScript 14 106 174 427 ---------------------------------------------------
---------------------------- SUM: 76 738 920 4170 ---------------------------------
----------------------------------------------

Այս ելքը ցույց է տալիս յուրաքանչյուր ծրագրավորման լեզվի ֆայլերի, դատարկ տողերի, մեկնաբանությունների և կոդերի քանակը: Այն նաև ներառում է նախագծում առկա կոդերի ընդհանուր տողերի ամփոփագիրը:

Օգտագործելով cloc Options

cloc-ը տրամադրում է մի քանի տարբերակ՝ գործիքի ելքը և վարքագիծը հարմարեցնելու համար: Օրինակ, դուք կարող եք օգտագործել --exclude-dir տարբերակը վերլուծությունից որոշ դիրեկտորիաներ բացառելու համար, կամ --csv տարբերակը՝ արդյունքները CSV ձևաչափով հետագա վերլուծության համար դուրս բերելու համար:

Ահա օգտակար cloc ընտրանքների մի քանի օրինակներ −

• --exclude-dir=dir1,dir2 − Բացառել dir1 և dir2 դիրեկտորիաները վերլուծությունից:

• --exclude-ext=ext1,ext2 - Բացառել ext1 և ext2 ընդլայնումներով ֆայլերը վերլուծությունից:

• --ignore-case − Անտեսել գործը կոդի տողերը հաշվելիս:

• --հանգիստ − Չեղարկեք առանձին ֆայլերի քանակի արդյունքը և ցուցադրեք միայն ամփոփումը:

• --ըստ ֆայլի - Ցուցադրել արդյունքները ըստ առանձին ֆայլի, ոչ թե ըստ ծրագրավորման լեզվի:

Cloc ընտրանքների ամբողջական ցանկի համար կարող եք օգտագործել --help տարբերակը.

cloc --help

Եկեք անցնենք այն հարցին, թե ինչպես օգտագործել cloc-ը տարբեր ծրագրավորման լեզուներով կոդերի տողերը հաշվելու համար:

Օգտագործելով cloc

cloc-ը կարող է տեղադրվել տարբեր հարթակներում, ներառյալ Linux, macOS և Windows: Այն հասանելի է նաև որպես Docker պատկեր: Երբ դուք տեղադրել եք cloc-ը, կարող եք այն օգտագործել ձեր նախագծի կոդի տողերը հաշվելու համար:

Ահա cloc-ի օգտագործման հիմնական շարահյուսությունը:

cloc [options] [file/dir(s)]

Դուք կարող եք տրամադրել ընտրանքներ հրամանի ելքը հարմարեցնելու համար: Օրինակ, դուք կարող եք օգտագործել --exclude-dir տարբերակը, որպեսզի բացառեք դիրեկտորիաների հաշվառումը: Ահա մի օրինակ -

cloc --exclude-dir=node_modules .

Այս հրամանը հաշվում է ընթացիկ գրացուցակի կոդի տողերը՝ միաժամանակ բացառելով node_modules գրացուցակը:

Լռելյայնորեն, cloc-ը հաշվում է կոդերի տողերը ավելի քան 200 ծրագրավորման լեզուներով: Կարող եք նաև նշել այն լեզուները, որոնք ցանկանում եք հաշվել՝ օգտագործելով --include-lang տարբերակը: Օրինակ՝ հետևյալ հրամանը հաշվում է միայն Python և JavaScript ֆայլերի կոդի տողերը −

cloc --include-lang=Python,JavaScript .

Դուք կարող եք նաև օգտագործել --csv տարբերակը՝ արդյունքը որպես CSV ֆայլ դուրս բերելու համար: Սա օգտակար է, եթե ցանկանում եք մշակել ելքը՝ օգտագործելով սցենար: Օրինակ −

cloc --csv . > result.csv

Այս հրամանը հաշվում է ընթացիկ գրացուցակի կոդի տողերը և արդյունքը պահպանում է որպես result.csv անունով CSV ֆայլ:

Cloc-ի համար շատ այլ տարբերակներ կան: Դուք կարող եք ստուգել փաստաթղթերը ամբողջական ցանկի համար:

Եզրակացություն

Այս հոդվածում մենք դիտարկել ենք cloc-ը՝ հրամանի տող գործիք՝ ծրագրավորման բազմաթիվ լեզուներում կոդի տողերը հաշվելու համար: Մենք տեսել ենք, թե ինչպես տեղադրել cloc-ը Linux-ում և ինչպես օգտագործել այն գրացուցակի, ֆայլի կամ սեղմված արխիվի կոդերի տողերը հաշվելու համար: Մենք նաև դիտարկել ենք cloc-ի վարքագիծը հարմարեցնելու տարբեր տարբերակներ, օրինակ՝ նշելով, թե որ լեզուները պետք է հաշվել և արդյունքները տարբեր ձևաչափերով դուրս բերել:

cloc-ը հզոր գործիք է, որը կարող է օգնել մշակողներին և նախագծերի ղեկավարներին ավելի լավ հասկանալ իրենց կոդերի բազայի չափն ու բարդությունը: Օգտագործելով cloc-ը, դուք կարող եք արագ և հեշտությամբ ստանալ ձեր նախագծի կոդի տողերի ճշգրիտ հաշվարկը, ինչը կարող է օգնել ձեզ տեղեկացված որոշումներ կայացնել կոդի որակի, պահպանման և արտադրողականության վերաբերյալ: Այսպիսով, եթե դեռ չեք արել, փորձեք cloc-ը և տեսեք, թե ինչպես դա կարող է օգնել ձեզ ավելի լավ հասկանալ ձեր կոդը: