譯者 | 布加迪

審校 | 重樓

Ruff簡介

Ruff是一個用Rust編寫的運行速度極快的Python代碼檢查器和格式化器，旨在取代和改進Flake8、Black和isort等現有工具。它將性能提升了10倍至100倍，同時通過700多個內置規則和重新實現的流行插件保持奇偶校驗。

圖1.從頭開始檢查CPython代碼庫

Ruff與Python 3.12兼容，支持現代 Python。它還提供自動修復支持、緩存和編輯器集成。Ruff對單一代碼庫友好，用于Pandas和FastAPI等各大開源項目。由于集速度、功能和可用性于一體，Ruff將代碼檢查、格式化和自動修復集成到統一的工具中，速度比現有的工具快幾個數量級。

Ruff入門

我們可以使用PIP輕松安裝Ruff。

pip install ruff

為了測試Ruff運行起來有多容易多快速，我們可以使用DagHub存儲庫kingabzpro/Yoga-Pose-Classification。您可以克隆它，也可以使用自己的項目進行格式化。

圖2. 項目結構

首先，我們將對項目運行代碼檢查。您也可以對單個文件運行代碼檢查，只需把“.”換成文件位置。

ruff check .

Ruff已經確定了9個錯誤和1個可修復的錯誤。為了修復這個錯誤，我們將使用--fix標志。

ruff check --fix

正如您所見，它修復了1個可修復的錯誤。

若要格式化項目，我們可以使用“ruff format”命令。

$ ruff format .
>>> 3 files reformatted

Ruff代碼檢查器和格式化器對代碼進行了大量更改。但是我們為什么需要這些工具？答案很簡單——它們有利于執行編碼標準和約定。因此，您和您的團隊可以專注于代碼的重要方面。此外，它們有助于提高代碼的質量、可維護性和安全性。

檢查和格式化Jupyter Notebooks

要在項目中使用Ruff for Jupyter Notebooks，您必須創建“ruff.toml”文件，并添加以下代碼：

extend-include = ["*.ipynb"]

您還可以對“pyproject .toml”執行相同的操作。

之后，重新運行命令，看看它是否對Jupyter notebook文件進行了更改。

2個文件被重新格式化，我們有2個Notebook文件。

$ ruff format .
>>> 2 files reformatted, 3 files left unchanged

我們還通過再次運行“check”命令修復這些文件中的問題。

$ ruff check --fix .
>>> Found 51 errors (6 fixed, 45 remaining).

最后的結果是驚人的。它在不破壞代碼的情況下進行了所有必要的更改。

Ruff配置

很容易為Jupyter Notebooks配置Ruff，只需編輯“ruff.toml”文件來調整代碼檢查器和格式化器設置。請查看配置Ruff文檔以了解更多詳細信息。

target-version = "py311"
extend-include = ["*.ipynb"]
line-length = 80

[lint]
extend-select = [
 "UP", # pyupgrade
 "D", # pydocstyle
]

[lint.pydocstyle]
convention = "google"

GitHub Action和預提交鉤子

開發人員和團隊可以通過“ruff -pre-commit”將Ruff用作預提交鉤子：

- repo: https://github.com/astral-sh/ruff-pre-commit
 # Ruff version.
 rev: v0.1.5
 hooks:
 # Run the linter.
 - id: ruff
 args: [ --fix ]
 # Run the formatter.
 - id: ruff-format

它還可以通過“ruff-action”用作GitHub Action：

name: Ruff
on: [ push, pull_request ]
jobs:
 ruff:
 runs-on: ubuntu-latest
 steps:
 - uses: actions/checkout@v3
 - uses: chartboost/ruff-action@v1

Ruff VSCode擴展

Ruff最討人喜歡的方面是其VSCode擴展。它簡化了格式化和代碼檢查，因而不需要第三方擴展。只需在擴展市場上搜索Ruff即可安裝它。

我已經配置了“setting.json”，以便在保存時格式化。

結語

Ruff提供了速度飛快的代碼檢查和格式化，使Python代碼更干凈、更一致。Ruff從Flake8、isort和pyupgrade等流行工具中汲取靈感，通過用Rust重新實現700多個內置規則來提高性能，從而實現了一套全面的編碼最佳實踐。精挑細選的規則集專注于捕捉錯誤和關鍵的風格問題，又不過度挑剔。

與預提交鉤子、GitHub Actions和VSCode等編輯器無縫集成使用戶可以將Ruff輕松整合到現代Python工作流中。無與倫比的速度和精心設計的規則集使Ruff成為重視快速反饋、干凈代碼和團隊順暢協作的Python開發人員的必備工具。Ruff通過將強大的功能與出色的性能相結合，為Python代碼檢查和格式化設立了新的標準。

原文標題：Enhance Your Python Coding Style with Ruff，作者：Abid Ali Awan