pilint

PROGRAM:

NUME

pilint - verificator static cod python

REZUMAT

pilint [ OPŢIUNI ] [ ]

DESCRIERE

pilint este un analizor de cod sursă Python care caută erori de programare, ajută
aplicarea unui standard de codificare și adulmecăt pentru unele mirosuri de cod (așa cum este definit în Martin Fowler
carte de refactorizare)

Pylint poate fi văzut ca un alt PyChecker, deoarece aproape toate testele pe care le puteți face cu PyChecker
se poate face si cu Pylint. Cu toate acestea, Pylint oferă câteva caracteristici suplimentare, cum ar fi verificarea
lungimea liniilor de cod, verificând dacă numele variabilelor sunt bine formate conform dvs
standard de codare sau verificarea dacă interfețele declarate sunt cu adevărat implementate și multe altele.

În plus, este posibil să scrieți pluginuri pentru a adăuga propriile verificări.

Pylint este livrat cu „pylint-gui”, „pyreverse” (generator de diagrame UML) și „similar” (un
verificator independent de asemănări).

OPŢIUNI

--versiune
afișați numărul versiunii programului și ieșiți

--ajutor, -h
afișați acest mesaj de ajutor și ieșiți

--lung-ajutor
ajutor mai detaliat.

MASTER

--rcfile=
Specificați un fișier de configurare.

--init-hook=
Cod Python de executat, de obicei pentru manipularea sys.path, cum ar fi pygtk.require().

--doar erori, -E
În modul de eroare, verificatoarele fără mesaje de eroare sunt dezactivate și numai pentru alții
mesajele de EROARE sunt afișate și nu se fac rapoarte în mod implicit

--py3k În modul de portare Python 3, toate verificatoarele vor fi dezactivate și vor fi emise numai mesajele
de către verificatorul de portare va fi afișat

--ignora= [, ...]
Adăugați fișiere sau directoare la lista neagră. Ar trebui să fie nume de bază, nu căi.
[actual: CVS]

--persistent=
Pickle a colectat date pentru comparații ulterioare. [actual: da]

--load-plugins=
Lista de pluginuri (ca valori separate prin virgulă ale numelor modulelor Python) de încărcat,
de obicei pentru a înregistra dame suplimentare. [actual: niciunul]

--locuri de muncă= , -j
Utilizați mai multe procese pentru a accelera Pylint. [actual: 1]

--extension-pkg-whitelist=
O listă separată prin virgulă de nume de pachete sau module de unde pot fi extensiile C
încărcat. Extensiile se încarcă în interpretul activ Python și pot rula
cod arbitrar [actual: niciunul]

COMANDE

--help-msg=
Afișați un mesaj de ajutor pentru ID-ul mesajului dat și ieșiți. Valoarea poate fi o virgulă
listă separată de ID-uri de mesaje.

--list-msgs
Generați mesajele lui pylint.

--list-conf-levels
Generați mesajele lui pylint.

--documentație completă
Generați documentația completă a lui pylint.

--generate-rcfile
Generați un exemplu de fișier de configurare conform configurației curente. Tu
pot pune alte opțiuni înaintea acesteia pentru a le obține în configurația generată.

MESAJE CONTROL

--incredere=
Afișați numai avertismente cu nivelurile de încredere enumerate. Lăsați gol pentru a afișa tot.
Niveluri valide: HIGH, INFERENCE, INFERENCE_FAILURE, UNDEFINED [actual: niciunul]

--enable= , -e
Activați mesajul, raportul, categoria sau verificatorul cu ID-urile date. Poti
fie dați un identificator multiplu separat prin virgulă (,) sau puneți această opțiune multiplu
timp. Consultați și opțiunea „--disable” pentru exemple.

--disable= , -d
Dezactivați mesajul, raportul, categoria sau verificatorul cu ID-urile date. Poti
fie dați mai mulți identificatori separați prin virgulă (,) sau puneți această opțiune multiplu
ori (doar pe linia de comandă, nu în fișierul de configurare unde ar trebui
apare o singură dată).Puteți folosi și „--disable=all” pentru a dezactiva totul mai întâi și
apoi reactivați verificările specifice. De exemplu, dacă doriți să rulați numai
verificator de asemănări, puteți folosi „--disable=all --enable=similarities”. daca tu
doresc să ruleze doar verificatorul de clase, dar nu au afișate mesaje de nivel de avertizare,
folosește"--disable=toate --enable=clasele --disable=W"

RAPOARTE

--output-format= , -f
Setați formatul de ieșire. Formatele disponibile sunt text, analizabil, colorat, msvs
(studio vizual) și html. De asemenea, puteți da un curs de reporter, de ex
mypackage.mymodule.MyReporterClass. [actual: text]

--files-output=
Puneți mesajele într-un fișier separat pentru fiecare modul/pachet specificat în comandă
linie în loc să le imprimați pe stdout. Rapoartele (dacă există) vor fi scrise într-un fișier
numele „pylint_global.[txt|html]”. [actual: nu]

--rapoarte= , -r
Spune dacă să afișați un raport complet sau numai mesajele [actual: da]

--evaluare=
Expresie Python care ar trebui să returneze o notă mai mică de 10 (10 este nota cea mai înaltă).
Aveți acces la variabile erori de avertizare, declarație care respectiv
conțin numărul de mesaje de erori/avertismente și numărul total de declarații
analizate. Acesta este utilizat de raportul de evaluare globală (RP0004). [curent: 10.0 -
((float(5 * eroare + avertisment + refactor + convenție) / declarație) * 10)]

--comment=
Adaugă un comentariu conform notei de evaluare. Acesta este folosit de global
raport de evaluare (RP0004). [actual: nu]

--msg-template=
Șablon folosit pentru afișarea mesajelor. Acesta este un șir de format Python în stil nou folosit pentru
formatați informațiile despre mesaj. Consultați documentul pentru toate detaliile

EXCEPȚII

--excepții-supragenerale=
Excepții care vor emite un avertisment atunci când sunt prinși. Implicit la „Excepție”
[actual: excepție]

CLASE

--ignore-iface-methods=
Lista metodelor de interfață de ignorat, separate prin virgulă. Acesta este folosit pentru
instanța de a nu verifica metodele definite în clasa de bază Interfață Zope. [actual:
isImplementedBy,deferred,extends,names,namesAndDescriptions,queryDescriptionFor,getBases,getDescriptionFor,getDoc,getName,getTaggedValue,getTaggedValueTags,isEqualOrExtendedBy,setTaggedValue,isImplementedByInstancesOf,is_adaptementsOf_

--defining-attr-methods=
Lista numelor de metode utilizate pentru a declara (adică atribui) atribute ale instanțelor. [actual:
__init__,__new__,setUp]

--valid-classmethod-first-arg=
Lista de nume valide pentru primul argument dintr-o metodă de clasă. [curent: cls]

--valid-metaclass-classmethod-first-arg=
Lista de nume valide pentru primul argument dintr-o metodă de clasă metaclasă. [actual:
mcs]

--exclude-protected=
Lista de nume de membri, care ar trebui excluse din avertismentul de acces protejat.
[current: _asdict,_fields,_replace,_source,_make]

LOGARE

--logging-modules=
Module de înregistrare pentru a verifica dacă argumentele formatului șirului sunt în funcția de înregistrare
format parametru [actual: înregistrare]

VARIABILE

--init-import=
Spune dacă ar trebui să verificăm importul neutilizat în fișierele __init__. [actual: nu]

--variabile-dummy-rgx=
O expresie regulată care se potrivește cu numele variabilelor fictive (adică, de așteptat, nu
folosit). [curent: _$|dummy]

--aditional-builtins=
Lista de nume suplimentare care ar trebui să fie definite în interior. Amintește-ți că tu
ar trebui să evite definirea de noi built-in atunci când este posibil. [actual: niciunul]

--callbacks=
Listă de șiruri care pot identifica o funcție de apel invers după nume. Un nume de apel invers
trebuie să înceapă sau să se termine cu unul dintre acele șiruri. [curent: cb_,_cb]

PROIECTARE

--max-args=
Numărul maxim de argumente pentru funcție/metodă [actual: 5]

--ignored-argument-names=
Numele argumentelor care se potrivesc cu această expresie vor fi ignorate. Implicit pentru nume cu
liniuță de subliniere principală [actual: _.*]

--max-locals=
Numărul maxim de localnici pentru funcția/corpul metodei [actual: 15]

--max-returns=
Numărul maxim de returnare/randament pentru corpul funcției/metodei [curent: 6]

--max-ramuri=
Numărul maxim de ramuri pentru corpul funcției / metodei [actual: 12]

--max-instrucțiuni=
Numărul maxim de instrucțiuni în corpul funcției / metodei [actual: 50]

--max-parinti=
Numărul maxim de părinți pentru o clasă (vezi R0901). [actual: 7]

--max-atribute=
Numărul maxim de atribute pentru o clasă (vezi R0902). [actual: 7]

--min-public-methods=
Numărul minim de metode publice pentru o clasă (vezi R0903). [actual: 2]

--max-public-methods=
Numărul maxim de metode publice pentru o clasă (vezi R0904). [actual: 20]

BASIC

--required-attributes=
Atribute necesare pentru modul, separate prin virgulă [current: none]

--funcții-proaste=
Lista de nume de funcții încorporate care nu ar trebui folosite, separate prin virgulă
[curent: hartă, filtru, intrare]

--nume-bine=
Nume bune de variabile care ar trebui întotdeauna acceptate, separate prin virgulă [current:
i,j,k,ex,Run,_]

--nume-proaste=
Nume de variabile greșite care ar trebui întotdeauna refuzate, separate prin virgulă [current:
foo,bar,baz,toto,tutu,tata]

--name-group=
Seturi de nume delimitate de două puncte care determină unul altuia stilul de denumire atunci când
Numele regexe permit mai multe stiluri. [actual: niciunul]

--include-naming-hint=
Includeți un indiciu pentru formatul corect de denumire cu invalid-name [current: no]

--function-rgx=
Expresie regulată care corespunde numelor corecte de funcții [current: [a-z_][a-
z0-9_]{2,30}$]

--function-name-hint=
Sugestie de denumire pentru numele funcțiilor [current: [a-z_][a-z0-9_]{2,30}$]

--variable-rgx=
Expresie regulată care se potrivește cu numele corecte de variabile [current: [a-z_][a-
z0-9_]{2,30}$]

--variable-name-hint=
Sugestie de denumire pentru numele variabilelor [current: [a-z_][a-z0-9_]{2,30}$]

--const-rgx=
Expresie regulată care se potrivește cu numele constantelor corecte [current: (([A-Z_][A-
Z0-9_]*)|(__.*__))$]

--const-name-hint=
Sugestie de denumire pentru nume constante [current: (([A-Z_][A-Z0-9_]*)|(__.*__))$]

--attr-rgx=
Expresie regulată care se potrivește cu numele atributelor corecte [current: [a-z_][a-
z0-9_]{2,30}$]

--attr-name-hint=
Sugestie de denumire pentru numele atributelor [current: [a-z_][a-z0-9_]{2,30}$]

--argument-rgx=
Expresie regulată care se potrivește cu numele argumentelor corecte [current: [a-z_][a-
z0-9_]{2,30}$]

--argument-name-hint=
Sugestie de denumire pentru numele argumentelor [current: [a-z_][a-z0-9_]{2,30}$]

--class-attribute-rgx=
Expresia regulată care corespunde numelor corecte de atribute ale clasei [current: ([A-Za-z_][A-
Za-z0-9_]{2,30}|(__.*__))$]

--class-attribute-name-hint=
Sugestie de denumire pentru numele atributelor de clasă [current: ([A-Za-z_][A-Za-
z0-9_]{2,30}|(__.*__))$]

--inlinevar-rgx=
Expresia regulată care corespunde numelor corecte de iterație în linie [current: [A-Za-z_][A-
Za-z0-9_]*$]

--inlinevar-name-hint=
Sugestie de denumire pentru numele de iterație în linie [current: [A-Za-z_][A-Za-z0-9_]*$]

--class-rgx=
Expresie regulată care se potrivește cu numele corecte de clasă [current: [A-Z_][a-zA-Z0-9]+$]

--class-name-hint=
Sugestie de denumire pentru numele claselor [actual: [A-Z_][a-zA-Z0-9]+$]

--module-rgx=
Expresie regulată care corespunde numelor corecte ale modulelor [current: (([a-z_][a-z0-9_]*)|([A-
Z][a-zA-Z0-9]+))$]

--module-name-hint=
Sugestie de denumire pentru numele modulelor [current: (([a-z_][a-z0-9_]*)|([AZ][a-zA-Z0-9]+))$]

--method-rgx=
Expresia regulată care se potrivește cu numele corecte ale metodei [current: [a-z_][a-z0-9_]{2,30}$]

--method-name-hint=
Sugestie de denumire pentru numele metodelor [current: [a-z_][a-z0-9_]{2,30}$]

--no-docstring-rgx=
Expresie regulată care ar trebui să se potrivească numai cu numele de funcții sau clase care nu se potrivesc
necesită un docstring. [actual: __.*__]

--docstring-min-length=
Lungimea minimă a liniei pentru funcțiile/clasele care necesită documente, cele mai scurte sunt
scuti. [actual: -1]

DIVERSE

--note=
Listă de etichete de note de luat în considerare, separate prin virgulă. [actual:
FIXME,XXX,TODO]

VERIFICARE DE TIPO

--ignore-mixin-membri=
Spune dacă membrii lipsă accesați în clasa mixin ar trebui ignorați. Un mixin
clasa este detectată dacă numele ei se termină cu „mixin” (indiferență majuscule și minuscule). [actual: da]

--module-ignorate=
Lista numelor de module pentru care nu trebuie verificate atributele membrilor (utilă pentru
module/proiecte în care spațiile de nume sunt manipulate în timpul rulării și astfel există
Atributele membrilor nu pot fi deduse prin analiză statică [current: none]

--ignored-classes=
Lista numelor de clase pentru care atributele membrilor nu trebuie verificate (utile pentru
clase cu atribute setate dinamic). [curent: SQLObject]

--zope=
Când modul zope este activat, adăugați un set predefinit de atribute dobândite Zope la
membri-generaţi. [actual: nu]

--membri-generați=
Lista de membri care sunt setate dinamic și ratați de sistemul de inferență pylint,
și deci nu ar trebui să declanșeze E1101 când este accesat. Expresiile regulate Python sunt
admis. [current: REQUEST,acl_users,aq_parent]

ORTOGRAFIE

--spelling-dict=
Numele dicționarului de ortografie. Dicționare disponibile: niciunul. Pentru ca acesta să funcționeze, instalați
pachet python-enchant. [actual: niciunul]

--ortografie-ignora-cuvinte=
Listă de cuvinte separate prin virgulă care nu trebuie verificate. [actual: niciunul]

--spelling-private-dict-file=
O cale către un fișier care conține dicționar privat; un cuvânt pe rând. [actual:
nici unul]

--spelling-store-unknown-words=
Spune dacă să stocheze cuvinte necunoscute în dicționarul privat indicat în --ortografie-
opțiunea private-dict-file în loc să ridice un mesaj. [actual: nu]

FORMAT

--max-line-length=
Numărul maxim de caractere pe o singură linie. [actual: 100]

--ignore-long-lines=
Regexp pentru o linie care poate fi mai lungă decât limita. [curent: ^(#
)? ?$]

--single-line-if-stmt=
Permiteți corpului unui if să fie pe aceeași linie cu testul dacă nu există altceva.
[actual: nu]

--no-space-check=NO_SPACE_CHECK
Lista de constructe opționale pentru care verificarea spațiilor albe este dezactivată [current:
virgulă finală, separator-dict]

--max-module-lines=
Numărul maxim de linii într-un modul [actual: 1000]

--indent-string=
Șir folosit ca unitate de indentare. Acesta este de obicei „ ” (4 spații) sau „” (1 filă).
[actual: ' ']

--indent-after-paren=
Numărul de spații de indentare necesare în interiorul unei linii suspendate sau continuate. [actual:
4]

--expected-line-ending-format=
Formatul așteptat de sfârșit de linie, de exemplu, gol (orice sfârșit de linie), LF sau CRLF. [actual:
nici unul]

IMPORTURI

--deprecated-modules=
Module depreciate care nu ar trebui folosite, separate prin virgulă [current:
regsub,TERMIOS,Bastion,rexec]

--import-graph=
Creați un grafic al fiecărei dependențe (adică interne și externe) din fișierul dat
(raportul RP0402 nu trebuie să fie dezactivat) [actual: niciunul]

--ext-import-graph=
Creați un grafic al dependențelor externe în fișierul dat (raportul RP0402 nu trebuie
fi dezactivat) [actual: niciunul]

--int-import-graph=
Creați un grafic al dependențelor interne în fișierul dat (raportul RP0402 nu trebuie
fi dezactivat) [actual: niciunul]

ASEMĂNĂRI

--min-linii-asemănătoare=
Numărul minim de linii ale unei asemănări. [actual: 4]

--ignore-comments=
Ignorați comentariile atunci când calculați asemănările. [actual: da]

--ignore-docstrings=
Ignorați documentele atunci când calculați asemănările. [actual: da]

--ignore-imports=
Ignorați importurile atunci când calculați asemănările. [actual: nu]

MEDIUL VARIABILE

Sunt utilizate următoarele variabile de mediu:
* PYLINTHOME
Calea către directorul în care va fi stocat persistentul pentru rulare. Dacă nu este găsit,
este implicit ~/.pylint.d/ sau .pylint.d (în directorul de lucru curent).
* PYLINTRC
Calea către fișierul de configurare. Consultați documentația pentru metoda utilizată pentru căutare
pentru fișierul de configurare.

REZULTATE

Folosind textul implicit, formatul mesajului este:

MESSAGE_TYPE: LINE_NUM:[OBJECT:] MESSAGE

Există 5 tipuri de mesaje:
* (C) convenție, pentru încălcarea standardului de programare
* (R) refactor, pentru miros neplăcut de cod
* (W) avertisment, pentru probleme specifice python
* Eroare (E), pentru erori probabile din cod
* (F) fatal, dacă a apărut o eroare care a împiedicat pylint să facă mai departe
prelucrare.

REZULTATE STAREA COD

Pylint ar trebui să plece cu următorul cod de stare:
* 0 dacă totul a mers bine
* 1 dacă a fost emis un mesaj fatal
* 2 dacă a fost emis un mesaj de eroare
* 4 dacă a fost emis un mesaj de avertizare
* 8 dacă a fost emis un mesaj de refactor
* 16 dacă a fost emis un mesaj de convenție
* 32 la eroare de utilizare

starea de la 1 la 16 va fi biți-OR, astfel încât să puteți ști ce categorii diferite au fost emise
prin analiza codului de stare a ieșirii pylint

Utilizați pylint online folosind serviciile onworks.net