メインコンテンツへスキップ
見出し画像

うちのPython、3つのツールをRuff 1本に。まず `ruff check .` だけ打とう

    ## 今夜のひとこと


    水曜の夜、FastAPIの小さなAPIを触っていて、ふと手が止まった。flake8は入れたっけ、Blackの設定はどこだっけ、importの並びはisort任せだっけ。Pythonを書くたびに道具の名前が3つ出てくる。1本にまとまらないものか、と思った夜だった。


    Pythonを書く人は全員、今日の話の対象です。まずやることは1つだけ。`ruff check .` を打ってみることです。


    ## 要点まとめ


    - RuffはAstral製の、Rustで書かれたPythonのリンター兼フォーマッター。flake8・Black・isortの3役を1本でやる。

    - まず打つのは `ruff check .`。直せるものは `ruff check --fix .`、整形は `ruff format .`。

    - 設定は `pyproject.toml` に数行だけ。型チェックは別物なので、mypyやpyrightの代わりにはならない。


    ## 1つ目:3つの道具を1本にまとめる


    今までPythonの品質管理は分業が当たり前だった。flake8が文法やスタイルの指摘、Blackが整形、isortがimportの並び替え。入れるものが3つ、設定ファイルも3つ、CIで呼ぶ回数も3回。どれか1つが古くなれば、また調べ直しだ。


    Ruffはこの3役を1本のバイナリにまとめたツールだ。FastAPIやPydanticといった大きなプロジェクトでも使われている。Rust製で速い、という話はよく聞く。でも僕が大事だと思うのは速さより「数が1つになる」ことだ。覚えるコマンドが1つ、設定ファイルが1つ。道具が減ると、迷う場所も減る。


    ## 2つ目:まず打つのは `ruff check .` だけ


    入れるのは1行だ。


    ```bash

    pip install ruff

    ```


    uvを使っているなら `uv add --dev ruff` でもいい。入れたら、まずこれだけ打つ。


    ```bash

    ruff check .

    ```


    出てきた指摘を、まずは眺めるだけでいい。直せるものだけ直すなら `ruff check --fix .`、整形だけ確認したいときは `ruff format --check .` で、ファイルを書き換えずに差分を見られる。問題なければ `ruff format .` で整形する。Blackと互換性がある作りなので、乗り換えても整形結果はほぼ変わらない。初回は `git diff` で差分を確認してからコミットすればいい。


    ## 3つ目:設定は `pyproject.toml` に3行だけ


    設定は `pyproject.toml` にまとめる。最初はこれだけで十分だ。


    ```toml

    [tool.ruff]

    line-length = 88


    [tool.ruff.lint]

    select = ["E", "F", "I"]

    ```


    `line-length = 88` はBlackと同じ既定の行の長さ。`select` は見るルールの種類で、`E` がエラー系、`F` が未使用の変数やimportなどの指摘、`I` がimportの並び替えだ。最初から全部入れると指摘が多すぎて嫌になるから、3つから始めるのがちょうどいい。


    11月5日に書いたLefthookの話とつなげるなら、コミット前に `ruff check` と `ruff format --check` を走らせるのが次の1手だ。書式の話をレビューでしなくて済むようになる。


    ## 車の世界で言うと…


    点検の道具に似ていると思う。ブレーキはこの機械、排気はあの機械、と測る機械がバラバラだと、測り忘れが出る。1台のテスターでまとめて測れれば、忘れる場所がなくなる。道具が1つだと「あれ、入れてなかった」が起きにくい。


    ## 実務ではこう効く


    まず今日やることは3つだけ。

    1. `pip install ruff`(uvなら `uv add --dev ruff`)して、`ruff check .` を打つ。

    2. 出た指摘を眺めて、直せるものだけ `ruff check --fix .` で直す。

    3. `pyproject.toml` に `[tool.ruff]` を3行足して、チームで同じ設定にする。


    型チェックはRuffの仕事じゃない。mypyやpyrightとは役割が違うので、型を見たい人はそちらも別に残しておく。リンターとフォーマッターを1本にするだけでも、Pythonの現場はだいぶすっきりすると思う。


    ## 相棒キャラNibbleの一言


    「道具は少ないほうが、迷わないよ。まず1本、打ってみなよ。」


    ---


    ## 情報源


    - Ruff公式ドキュメント「FAQ」(2026-11-11確認):https://docs.astral.sh/ruff//faq/

    - Ruff(PyPI、0.17.2):https://pypi.org/project/ruff/0.17.2/


    ※2026年11月11日時点の情報です。Ruffの仕様やバージョンは変わるため、公式ドキュメントで確認してください。


    #Ruff #Python #FastAPI #Web開発 #開発効率化

     
     

    skcode

     
     
    自動車業界で12年エンジニアをして、2025年からWeb開発(React / Next.js)に転身しました。毎朝5時半に起きて走るのが日課。その朝の時間に、テックニュースから大事な1件だけを選んで書いています。AI・Web開発・セキュリティが中心です。

    あなたへのおすすめ