首頁 > 後端開發 > Python教學 > PyLint 的優點、缺點和危險

PyLint 的優點、缺點和危險

WBOY
發布: 2023-04-10 12:01:03
轉載
1964 人瀏覽過

PyLint 的優點、缺點和危險

充分利用 PyLint。

敲黑板:PyLint 其實很好!

“PyLint 可以拯救你的生命”,這是一句誇張的描述,但沒有你想像的那麼誇張。 PyLint 可以讓你遠離非常難找到的和複雜的缺陷。在最差的情況下,它只可以節省測試運行的時間。在最好的情況下,它可以幫助你避免生產環境中複雜的錯誤。

優點

我不好意思說這種情況是多麼普遍。測試的命名總是那麼奇怪:沒有人關心這個名稱,而且通常也找不到一個自然的名稱。例如以下程式碼:

def test_add_small():# Math, am I right?assert 1 + 1 == 3def test_add_large():assert 5 + 6 == 11def test_add_small():assert 1 + 10 == 11
登入後複製

測試生效:

collected 2 items test.py .. 2 passed
登入後複製

但問題是:如果你覆寫了一個測試的名稱,測試框架將愉快地跳過這個測試!

實際上,這些檔案可能有數百行,而新增測試的人可能不知道所有的名稱。除非有人仔細查看測試輸出,否則一切看起來都很好。

最糟糕的是,被覆蓋測試的添加被覆蓋測試造成的破壞,以及連鎖反應的問題可能要幾天、幾月甚至幾年才能發現。

PyLint 會找到它

就像一個好朋友一樣,PyLint 可以幫助你。

test.py:8:0: E0102: function already defined line 1 (function-redefined)
登入後複製

缺點

就像 90 年代的情境喜劇一樣,你對 PyLint 了解的越多,問題就越多。以下是一個庫存建模程式的常規代碼:

"""Inventory abstractions"""import attrs@attrs.defineclass Laptop:"""A laptop"""ident: strcpu: str
登入後複製

但PyLint 似乎有自己的觀點(可能形成於90 年代),並且不怕把它們作為事實陳述出來:

$ pylint laptop.py | sed -n '/^laptop/s/[^ ]*: //p'R0903: Too few public methods (0/2) (too-few-public-methods)
登入後複製

危險

有沒有想過在一個數百萬人使用的工具中加入自己未證實的觀點? PyLint 每月有 1200 萬次下載。

「如果太挑剔,人們會取消檢查」 — 這是PyLint GitHub 的6987 號議題,於2022 年7 月3 號提出

#對於新增一個可能有許多誤報的測試,它的態度是... “”。

讓它為你工作

PyLint 很好,但你需要小心地與它配合。為了讓 PyLint 為你工作,以下是我推薦的三件事:

1、固定版本

固定你使用的 PyLint 版本,避免任何驚喜!

在你的 .toml 檔案中定義:

[project.optional-dependencies]pylint = ["pylint"]
登入後複製

在程式碼中定義:

from unittest import mock
登入後複製

這與下列程式碼對應:

# noxfile.py...@nox.session(python=VERSIONS[-1])def refresh_deps(session):"""Refresh the requirements-*.txt files"""session.install("pip-tools")for deps in [..., "pylint"]:session.run("pip-compile","--extra",deps,"pyproject.toml","--output-file",f"requirements-{deps}.txt",)
登入後複製

2、預設禁止

停用所有檢查,然後啟用那些你認為誤報比率高的。 (不只是漏報/誤報的比率!)

# noxfile.py...@nox.session(python="3.10")def lint(session):files = ["src/", "noxfile.py"]session.install("-r", "requirements-pylint.txt")session.install("-e", ".")session.run("pylint","--disable=all",*(f"--enable={checker}" for checker in checkers)"src",)
登入後複製

3、檢查器

以下是我喜歡的檢查器。加強專案的一致性,避免一些明顯的錯誤。

checkers = ["missing-class-docstring","missing-function-docstring","missing-module-docstring","function-redefined",]
登入後複製

使用 PyLint

你可以只使用 PyLint 好的部分。在 CI 中運行它以保持一致性,並使用常用檢查器。

放棄不好的部分:預設禁止檢查器。

避免危險的部分:固定版本以避免意外。

以上是PyLint 的優點、缺點和危險的詳細內容。更多資訊請關注PHP中文網其他相關文章!

相關標籤:
來源:51cto.com
本網站聲明
本文內容由網友自願投稿,版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容,請聯絡admin@php.cn
熱門教學
更多>
最新下載
更多>
網站特效
網站源碼
網站素材
前端模板