pylint - Dalam talian di Awan

JADUAL:

NAMA

tiang kayu - pemeriksa statik kod python

SINOPSIS

tiang kayu [ PILIHAN ] [ ]

DESCRIPTION

tiang kayu ialah penganalisis kod sumber Python yang mencari ralat pengaturcaraan, membantu
menguatkuasakan standard pengekodan dan menghidu untuk beberapa bau kod (seperti yang ditakrifkan dalam Martin Fowler
Buku pemfaktoran semula)

Pylint boleh dilihat sebagai PyChecker lain kerana hampir semua ujian yang boleh anda lakukan dengan PyChecker
juga boleh dilakukan dengan Pylint. Walau bagaimanapun, Pylint menawarkan beberapa lagi ciri, seperti menyemak
panjang baris kod, menyemak sama ada nama pembolehubah dibentuk dengan baik mengikut anda
standard pengekodan, atau menyemak sama ada antara muka yang diisytiharkan benar-benar dilaksanakan, dan banyak lagi.

Selain itu, adalah mungkin untuk menulis pemalam untuk menambah cek anda sendiri.

Pylint dihantar dengan "pylint-gui", "pyreverse" (penjana rajah UML) dan "symilar" (an
penyemak persamaan bebas).

PILIHAN

--versi
tunjukkan nombor versi program dan keluar

--membantu, -h
tunjukkan mesej bantuan ini dan keluar

--panjang-membantu
bantuan yang lebih terperinci.

MASTER

--rcfile=
Tentukan fail konfigurasi.

--init-hook=
Kod Python untuk dilaksanakan, biasanya untuk manipulasi sys.path seperti pygtk.require().

--ralat-sahaja, -E
Dalam mod ralat, penyemak tanpa mesej ralat dilumpuhkan dan untuk orang lain, sahaja
mesej ERROR dipaparkan, dan tiada laporan dilakukan secara lalai

--py3k Dalam mod porting Python 3, semua penyemak akan dilumpuhkan dan hanya mesej yang dikeluarkan
oleh penyemak porting akan dipaparkan

--abaikan= [, ...]
Tambahkan fail atau direktori ke senarai hitam. Mereka sepatutnya menjadi nama asas, bukan laluan.
[semasa: CVS]

--berterusan=
Pickle mengumpul data untuk perbandingan kemudian. [semasa: ya]

--load-plugins=
Senarai pemalam (sebagai nilai dipisahkan koma bagi nama modul python) untuk dimuatkan,
biasanya untuk mendaftarkan dam tambahan. [semasa: tiada]

--pekerjaan= , -j
Gunakan pelbagai proses untuk mempercepatkan Pylint. [semasa: 1]

--extension-pkg-senarai putih=
Senarai nama pakej atau modul yang dipisahkan koma dari tempat sambungan C mungkin
dimuatkan. Sambungan sedang dimuatkan ke dalam penterjemah Python aktif dan mungkin dijalankan
kod arbitrari [semasa: tiada]

PERINTAH

--help-msg=
Paparkan mesej bantuan untuk id mesej yang diberikan dan keluar. Nilai mungkin koma
senarai id mesej yang dipisahkan.

--list-msgs
Hasilkan mesej pylint.

--list-conf-levels
Hasilkan mesej pylint.

--dokumentasi penuh
Hasilkan dokumentasi penuh pylint.

--generate-rcfile
Hasilkan fail konfigurasi sampel mengikut konfigurasi semasa. awak
boleh meletakkan pilihan lain sebelum ini untuk mendapatkannya dalam konfigurasi yang dijana.

PESAN KAWALAN

--keyakinan=
Hanya tunjukkan amaran dengan tahap keyakinan yang disenaraikan. Biarkan kosong untuk menunjukkan semua.
Tahap sah: TINGGI, INFERENCE, INFERENCE_FAILURE, UNDEFINED [semasa: tiada]

--dayakan= , -e
Dayakan mesej, laporan, kategori atau penyemak dengan id yang diberikan. Awak boleh
sama ada berikan berbilang pengecam yang dipisahkan dengan koma (,) atau letakkan pilihan ini berbilang
masa. Lihat juga pilihan "--disable" untuk contoh.

--disable= , -d
Lumpuhkan mesej, laporan, kategori atau penyemak dengan id yang diberikan. Awak boleh
sama ada berikan berbilang pengecam yang dipisahkan dengan koma (,) atau letakkan pilihan ini berbilang
kali (hanya pada baris arahan, bukan dalam fail konfigurasi yang sepatutnya
muncul sekali sahaja).Anda juga boleh menggunakan "--disable=all" untuk melumpuhkan semuanya dahulu dan
kemudian dayakan semula semakan khusus. Sebagai contoh, jika anda ingin menjalankan hanya
penyemak persamaan, anda boleh menggunakan "--disable=all --enable=similarities". Jika awak
mahu menjalankan hanya penyemak kelas, tetapi tiada mesej peringkat Amaran dipaparkan,
gunakan"--disable=all --enable=classes --disable=W"

LAPORAN

--output-format= , -f
Tetapkan format output. Format yang tersedia ialah teks, boleh dihuraikan, berwarna, msvs
(studio visual) dan html. Anda juga boleh memberikan kelas wartawan, cth
mypackage.mymodule.MyReporterClass. [semasa: teks]

--files-output=
Letakkan mesej dalam fail berasingan untuk setiap modul / pakej yang dinyatakan pada arahan
baris dan bukannya mencetaknya pada stdout. Laporan (jika ada) akan ditulis dalam fail
nama "pylint_global.[txt|html]". [semasa: tidak]

--laporan= , -r
Memberitahu sama ada mahu memaparkan laporan penuh atau hanya mesej [semasa: ya]

--penilaian=
Ungkapan Python yang sepatutnya mengembalikan nota kurang daripada 10 (10 ialah nota tertinggi).
Anda mempunyai akses kepada amaran ralat pembolehubah, pernyataan yang masing-masing
mengandungi bilangan ralat / mesej amaran dan jumlah bilangan kenyataan
dianalisis. Ini digunakan oleh laporan penilaian global (RP0004). [semasa: 10.0 -
((float(5 * ralat + amaran + refactor + konvensyen) / pernyataan) * 10)]

--komen=
Tambahkan ulasan mengikut nota penilaian anda. Ini digunakan oleh global
laporan penilaian (RP0004). [semasa: tidak]

--msg-template=
Templat digunakan untuk memaparkan mesej. Ini ialah rentetan format gaya baharu python yang digunakan
memformat maklumat mesej. Lihat doc untuk semua butiran

PENGECUALIAN

--overgeneral-exceptions=
Pengecualian yang akan mengeluarkan amaran apabila ditangkap. Lalai kepada "Pengecualian"
[semasa: Pengecualian]

KELAS

--abaikan-kaedah-iface=
Senarai kaedah antara muka untuk diabaikan, dipisahkan dengan koma. Ini digunakan untuk
contoh untuk tidak menyemak kaedah yang ditakrifkan dalam kelas asas Antara Muka Zope. [semasa:
isImplementedBy, deferred, extends, names, namesAndDescriptions,queryDescriptionFor,getBases,getDescriptionFor,getDoc,getName,getTaggedValue,getTaggedValueTags,isEqualOrExtendedBy,setTaggedValue,isImplementedByInstancesOf,is_adaptWith

--defining-attr-methods=
Senarai nama kaedah yang digunakan untuk mengisytiharkan (iaitu memberikan) atribut contoh. [semasa:
__init__,__new__,setUp]

--valid-classmethod-first-arg=
Senarai nama yang sah untuk hujah pertama dalam kaedah kelas. [semasa: cls]

--valid-metaclass-classmethod-first-arg=
Senarai nama yang sah untuk hujah pertama dalam kaedah kelas metaclass. [semasa:
mcs]

--exclude-protected=
Senarai nama ahli, yang harus dikecualikan daripada amaran akses yang dilindungi.
[semasa: _asdict,_fields,_replace,_source,_make]

MASUK

--logging-modules=
Modul pengelogan untuk memeriksa sama ada argumen format rentetan berada dalam fungsi pengelogan
format parameter [semasa: logging]

PELBAGAI

--init-import=
Memberitahu sama ada kita perlu menyemak import yang tidak digunakan dalam fail __init__. [semasa: tidak]

--dummy-variables-rgx=
Ungkapan biasa yang sepadan dengan nama pembolehubah tiruan (iaitu dijangka tidak
digunakan). [semasa: _$|dummy]

--builtin-tambahan=
Senarai nama tambahan yang sepatutnya ditakrifkan dalam binaan. Ingat bahawa anda
harus mengelak daripada menentukan binaan baharu apabila boleh. [semasa: tiada]

--panggilan balik=
Senarai rentetan yang boleh mengenal pasti fungsi panggil balik mengikut nama. Nama panggilan balik
mesti bermula atau berakhir dengan salah satu rentetan tersebut. [semasa: cb_,_cb]

REKABENTUK

--max-args=
Bilangan maksimum argumen untuk fungsi / kaedah [semasa: 5]

--ignoreed-argument-names=
Nama hujah yang sepadan dengan ungkapan ini akan diabaikan. Lalai untuk menamakan dengan
garis bawah terkemuka [semasa: _.*]

--max-locals=
Bilangan maksimum penduduk tempatan untuk badan fungsi / kaedah [semasa: 15]

--max-returns=
Bilangan maksimum pulangan / hasil untuk fungsi / badan kaedah [semasa: 6]

--cawangan-maks=
Bilangan maksimum cawangan untuk badan fungsi / kaedah [semasa: 12]

--penyata-maks=
Bilangan maksimum pernyataan dalam fungsi / badan kaedah [semasa: 50]

--maks-ibu bapa=
Bilangan maksimum ibu bapa untuk sesebuah kelas (lihat R0901). [semasa: 7]

--maks-atribut=
Bilangan maksimum atribut untuk kelas (lihat R0902). [semasa: 7]

--min-kaedah-awam=
Bilangan minimum kaedah awam untuk kelas (lihat R0903). [semasa: 2]

--maks-kaedah-awam=
Bilangan maksimum kaedah awam untuk kelas (lihat R0904). [semasa: 20]

ASAS

--atribut-diperlukan=
Atribut yang diperlukan untuk modul, dipisahkan dengan koma [semasa: tiada]

--buruk-fungsi=
Senarai nama fungsi terbina yang tidak boleh digunakan, dipisahkan dengan koma
[semasa: peta, penapis, input]

--nama-baik=
Nama pembolehubah yang baik yang harus sentiasa diterima, dipisahkan dengan koma [semasa:
i,j,k,ex,Run,_]

--nama-buruk=
Nama pembolehubah buruk yang harus selalu ditolak, dipisahkan dengan koma [semasa:
foo,bar,baz,toto,tutu,tata]

--nama-kumpulan=
Set nama yang dibataskan kolon yang menentukan gaya penamaan satu sama lain apabila
nama regex membenarkan beberapa gaya. [semasa: tiada]

--include-naming-hint=
Sertakan pembayang untuk format penamaan yang betul dengan nama tidak sah [semasa: tidak]

--function-rgx=
Ungkapan biasa yang sepadan dengan nama fungsi yang betul [semasa: [a-z_][a-
z0-9_]{2,30}$]

--function-name-hint=
Pembayang penamaan untuk nama fungsi [semasa: [a-z_][a-z0-9_]{2,30}$]

--pembolehubah-rgx=
Ungkapan biasa yang sepadan dengan nama pembolehubah yang betul [semasa: [a-z_][a-
z0-9_]{2,30}$]

--variable-name-hint=
Petua penamaan untuk nama pembolehubah [semasa: [a-z_][a-z0-9_]{2,30}$]

--const-rgx=
Ungkapan biasa yang sepadan dengan nama pemalar yang betul [semasa: (([A-Z_][A-
Z0-9_]*)|(__.*__))$]

--const-name-hint=
Petua penamaan untuk nama tetap [semasa: (([A-Z_][A-Z0-9_]*)|(__.*__))$]

--attr-rgx=
Ungkapan biasa yang sepadan dengan nama atribut yang betul [semasa: [a-z_][a-
z0-9_]{2,30}$]

--attr-name-hint=
Pembayang penamaan untuk nama atribut [semasa: [a-z_][a-z0-9_]{2,30}$]

--argument-rgx=
Ungkapan biasa yang sepadan dengan nama hujah yang betul [semasa: [a-z_][a-
z0-9_]{2,30}$]

--argument-name-hint=
Pembayang penamaan untuk nama argumen [semasa: [a-z_][a-z0-9_]{2,30}$]

--class-attribute-rgx=
Ungkapan biasa yang sepadan dengan nama atribut kelas yang betul [semasa: ([A-Za-z_][A-
Za-z0-9_]{2,30}|(__.*__))$]

--class-attribute-name-hint=
Pembayang penamaan untuk nama atribut kelas [semasa: ([A-Za-z_][A-Za-
z0-9_]{2,30}|(__.*__))$]

--inlinevar-rgx=
Ungkapan biasa yang sepadan dengan nama lelaran sebaris yang betul [semasa: [A-Za-z_][A-
Za-z0-9_]*$]

--inlinevar-name-hint=
Pembayang penamaan untuk nama lelaran sebaris [semasa: [A-Za-z_][A-Za-z0-9_]*$]

--class-rgx=
Ungkapan biasa yang sepadan dengan nama kelas yang betul [semasa: [A-Z_][a-zA-Z0-9]+$]

--class-name-hint=
Petua penamaan untuk nama kelas [semasa: [A-Z_][a-zA-Z0-9]+$]

--modul-rgx=
Ungkapan biasa yang sepadan dengan nama modul yang betul [semasa: (([a-z_][a-z0-9_]*)|([A-
Z][a-zA-Z0-9]+))$]

--nama-modul-petunjuk=
Petua penamaan untuk nama modul [semasa: (([a-z_][a-z0-9_]*)|([AZ][a-zA-Z0-9]+))$]

--kaedah-rgx=
Ungkapan biasa yang sepadan dengan nama kaedah yang betul [semasa: [a-z_][a-z0-9_]{2,30}$]

--nama-kaedah-petunjuk=
Pembayang penamaan untuk nama kaedah [semasa: [a-z_][a-z0-9_]{2,30}$]

--no-docstring-rgx=
Ungkapan biasa yang sepatutnya hanya sepadan dengan fungsi atau nama kelas yang tidak sepadan
memerlukan docstring. [semasa: __.*__]

--docstring-min-length=
Panjang baris minimum untuk fungsi/kelas yang memerlukan docstrings, yang lebih pendek adalah
dikecualikan. [semasa: -1]

PELBAGAI

--nota=
Senarai tag nota untuk dipertimbangkan, dipisahkan dengan koma. [semasa:
FIXME,XXX,TODO]

TYPECHECK

--abaikan-mixin-members=
Memberitahu sama ada ahli yang hilang yang diakses dalam kelas mixin harus diabaikan. Satu campuran
kelas dikesan jika namanya berakhir dengan "mixin" (tidak sensitif huruf besar-besaran). [semasa: ya]

--diabaikan-modul=
Senarai nama modul yang atribut ahli tidak boleh disemak (berguna untuk
modul/projek di mana ruang nama dimanipulasi semasa masa jalan dan dengan itu wujud
atribut ahli tidak boleh disimpulkan dengan analisis statik [semasa: tiada]

--diabaikan-kelas=
Senarai nama kelas yang atribut ahli tidak boleh disemak (berguna untuk
kelas dengan atribut ditetapkan secara dinamik). [semasa: SQLObject]

--zope=
Apabila mod zope diaktifkan, tambahkan set pratakrif atribut yang diperoleh Zope kepada
dijana-ahli. [semasa: tidak]

--generated-ahli=
Senarai ahli yang ditetapkan secara dinamik dan terlepas oleh sistem inferens pylint,
dan oleh itu tidak seharusnya mencetuskan E1101 apabila diakses. Ungkapan biasa Python ialah
diterima. [semasa: REQUEST,acl_users,aq_parent]

EJAAN

--ejaan-dikt=
Mengeja nama kamus. Kamus yang tersedia: tiada. Untuk menjadikannya berfungsi pasang
pakej python-enchant. [semasa: tiada]

--ejaan-abaikan-perkataan=
Senarai perkataan yang dipisahkan koma yang tidak boleh disemak. [semasa: tiada]

--spelling-private-dict-file=
Laluan ke fail yang mengandungi kamus peribadi; satu perkataan setiap baris. [semasa:
tiada]

--spelling-store-unknown-words=
Memberitahu sama ada untuk menyimpan perkataan yang tidak diketahui ke kamus peribadi yang ditunjukkan dalam --ejaan-
pilihan private-dict-file dan bukannya menaikkan mesej. [semasa: tidak]

FORMAT

--panjang-garis-maks=
Bilangan maksimum aksara pada satu baris. [semasa: 100]

--abaikan-garis-panjang=
Regexp untuk baris yang dibenarkan lebih panjang daripada had. [semasa: ^(#
)? ?$]

--baris-tunggal-jika-stmt=
Benarkan badan if berada pada baris yang sama dengan ujian jika tidak ada yang lain.
[semasa: tidak]

--no-space-check=NO_SPACE_CHECK
Senarai binaan pilihan yang penyemakan ruang putih dinyahdayakan [semasa:
trailing-comma, dict-separator]

--max-modul-garisan=
Bilangan maksimum baris dalam modul [semasa: 1000]

--indent-string=
Rentetan digunakan sebagai unit lekukan. Ini biasanya " " (4 ruang) atau "" (1 tab).
[semasa: ' ']

--indent-after-paren=
Bilangan ruang inden yang diperlukan dalam baris gantung atau berterusan. [semasa:
4]

--expected-line-ending-format=
Format jangkaan penghujung baris, cth kosong (mana-mana baris berakhir), LF atau CRLF. [semasa:
tiada]

IMPORT

--deprecated-modules=
Modul ditamatkan yang tidak boleh digunakan, dipisahkan dengan koma [semasa:
regsub,TERMIOS,Bastion,rexec]

--import-graf=
Cipta graf setiap kebergantungan (iaitu dalaman dan luaran) dalam fail yang diberikan
(laporan RP0402 tidak boleh dilumpuhkan) [semasa: tiada]

--ext-import-graph=
Buat graf kebergantungan luar dalam fail yang diberikan (laporkan RP0402 tidak boleh
dilumpuhkan) [semasa: tiada]

--int-import-graph=
Buat graf kebergantungan dalaman dalam fail yang diberikan (laporkan RP0402 tidak boleh
dilumpuhkan) [semasa: tiada]

PERSAMAAN

--min-similarity-lines=
Nombor baris minimum persamaan. [semasa: 4]

--abaikan-komen=
Abaikan ulasan semasa mengira persamaan. [semasa: ya]

--ignore-docstrings=
Abaikan docstrings semasa mengira persamaan. [semasa: ya]

--abaikan-import=
Abaikan import apabila mengira persamaan. [semasa: tidak]

PERSEKITARAN PELBAGAI

Pembolehubah persekitaran berikut digunakan:
* PILINTHOME
Laluan ke direktori tempat tetapan untuk larian akan disimpan. Jika tidak ditemui,
ia lalai kepada ~/.pylint.d/ atau .pylint.d (dalam direktori kerja semasa).
* PYLINTRC
Laluan ke fail konfigurasi. Lihat dokumentasi untuk kaedah yang digunakan untuk mencari
untuk fail konfigurasi.

OUTPUT

Menggunakan output teks lalai, format mesej ialah:

MESSAGE_TYPE: LINE_NUM:[OBJECT:] MESSAGE

Terdapat 5 jenis jenis mesej:
* (C) konvensyen, untuk pelanggaran standard pengaturcaraan
* (R) refactor, untuk bau kod busuk
* (W) amaran, untuk masalah khusus python
* (E) ralat, untuk kemungkinan pepijat dalam kod
* (F) maut, jika ralat berlaku yang menghalang pylint daripada melakukan lebih lanjut
pemprosesan.

OUTPUT STATUS KOD

Pylint harus keluar dengan kod status berikut:
* 0 jika semuanya berjalan lancar
* 1 jika mesej maut telah dikeluarkan
* 2 jika mesej ralat telah dikeluarkan
* 4 jika mesej amaran telah dikeluarkan
* 8 jika mesej refactor telah dikeluarkan
* 16 jika mesej konvensyen telah dikeluarkan
* 32 pada ralat penggunaan

status 1 hingga 16 akan bit-ORed supaya anda boleh mengetahui kategori berbeza yang telah dikeluarkan
dengan menganalisis kod status output pylint

Gunakan pylint dalam talian menggunakan perkhidmatan onworks.net