{"id":3430,"date":"2026-09-24T08:39:03","date_gmt":"2026-09-23T23:39:03","guid":{"rendered":"https:\/\/qol-kk.com\/wp2\/?p=3430"},"modified":"2026-09-24T08:39:03","modified_gmt":"2026-09-23T23:39:03","slug":"20260922-plan037","status":"publish","type":"post","link":"https:\/\/qol-kk.com\/wp2\/blog\/2026\/09\/24\/20260922-plan037\/","title":{"rendered":"Ruff \u3067 Python \u306e Lint + Format \u3092\u4e00\u62ec\u5b9f\u884c\u3059\u308b"},"content":{"rendered":"<h2>\u6982\u8981<\/h2>\n<p>Python \u306e Lint \u3068 Format \u306f\u3001\u9577\u3089\u304f <code>flake8<\/code> \/ <code>isort<\/code> \/ <code>black<\/code> \u306a\u3069\u3092\u7d44\u307f\u5408\u308f\u305b\u308b\u306e\u304c\u5b9a\u756a\u3060\u3063\u305f\u3002\u30c4\u30fc\u30eb\u3054\u3068\u306b\u8a2d\u5b9a\u30d5\u30a1\u30a4\u30eb\u304c\u5206\u304b\u308c\u3001\u5b9f\u884c\u3082\u5225\u3005\u3067\u3001CI \u306e\u30b9\u30c6\u30c3\u30d7\u3082\u5897\u3048\u308b\u3002<\/p>\n<p>Ruff \u306f Rust \u88fd\u306e Lint + Formatter \u3067\u3001\u3053\u308c\u3089\u3092 1 \u3064\u306e\u30c4\u30fc\u30eb\u306b\u96c6\u7d04\u3067\u304d\u308b\u3002\u7279\u5fb4\u306f\u5727\u5012\u7684\u306a\u901f\u3055\u3068\u3001\u65e2\u5b58\u306e\u4e3b\u8981\u30eb\u30fc\u30eb\u3092\u307b\u307c\u30ab\u30d0\u30fc\u3057\u3066\u3044\u308b\u70b9\u3002\u3053\u306e\u8a18\u4e8b\u3067\u306f\u3001Ruff \u3092\u5c0e\u5165\u3057\u3066 Lint \u3068 Format \u3092\u4e00\u62ec\u3067\u56de\u3059\u3068\u3053\u308d\u307e\u3067\u3092\u30cf\u30f3\u30ba\u30aa\u30f3\u3067\u9032\u3081\u308b\u3002<\/p>\n<h2>\u74b0\u5883<\/h2>\n<ul>\n<li>Python 3.11<\/li>\n<li>Ruff 0.6 \u7cfb\uff08<code>ruff --version<\/code> \u3067\u78ba\u8a8d\uff09<\/li>\n<li>\u30d1\u30c3\u30b1\u30fc\u30b8\u7ba1\u7406\u306f <code>pip<\/code> \u307e\u305f\u306f <code>uv<\/code> \u3092\u60f3\u5b9a<\/li>\n<\/ul>\n<p>Ruff \u306e\u30d0\u30fc\u30b8\u30e7\u30f3\u306f\u30eb\u30fc\u30eb\u306e\u6319\u52d5\u3084\u30c7\u30d5\u30a9\u30eb\u30c8\u304c\u5909\u308f\u308b\u3053\u3068\u304c\u3042\u308b\u305f\u3081\u3001\u8a18\u4e8b\u306e\u5185\u5bb9\u306f\u4e0a\u8a18\u524d\u63d0\u3068\u3059\u308b\u3002\u624b\u5143\u306e\u30d0\u30fc\u30b8\u30e7\u30f3\u306f\u5fc5\u305a\u78ba\u8a8d\u3057\u3066\u307b\u3057\u3044\u3002<\/p>\n<h2>\u30a4\u30f3\u30b9\u30c8\u30fc\u30eb<\/h2>\n<pre class=\"lang:default decode:true\"># pip\npip install ruff\n\n# uv \u3092\u4f7f\u3046\u5834\u5408\nuv add --dev ruff\n\n# \u30d0\u30fc\u30b8\u30e7\u30f3\u78ba\u8a8d\nruff --version<\/pre>\n<p>Ruff \u306f\u5358\u4e00\u30d0\u30a4\u30ca\u30ea\u3067\u3001\u8ffd\u52a0\u306e\u30d7\u30e9\u30b0\u30a4\u30f3\u3092\u5165\u308c\u306a\u304f\u3066\u3082\u591a\u304f\u306e\u30eb\u30fc\u30eb\u304c\u6700\u521d\u304b\u3089\u4f7f\u3048\u308b\u3002<\/p>\n<h2>Lint \u3092\u5b9f\u884c\u3059\u308b<\/h2>\n<pre class=\"lang:default decode:true\"># \u30ab\u30ec\u30f3\u30c8\u4ee5\u4e0b\u3092\u30c1\u30a7\u30c3\u30af\nruff check .\n\n# \u81ea\u52d5\u4fee\u6b63\u3067\u304d\u308b\u3082\u306e\u306f\u4fee\u6b63\u3059\u308b\nruff check . --fix\n\n# \u4fee\u6b63\u5185\u5bb9\u3092\u78ba\u8a8d\u3060\u3051\u3057\u305f\u3044\uff08\u5dee\u5206\u8868\u793a\uff09\nruff check . --diff<\/pre>\n<p><code>--fix<\/code> \u306f import \u306e\u4e26\u3073\u66ff\u3048\u3084\u672a\u4f7f\u7528 import \u306e\u524a\u9664\u306a\u3069\u3001\u6a5f\u68b0\u7684\u306b\u5b89\u5168\u306a\u4fee\u6b63\u3092\u81ea\u52d5\u3067\u5f53\u3066\u308b\u3002\u5b89\u5168\u3067\u306a\u3044\u4fee\u6b63\u307e\u3067\u542b\u3081\u305f\u3044\u5834\u5408\u306f <code>--unsafe-fixes<\/code> \u3092\u660e\u793a\u7684\u306b\u4ed8\u3051\u308b\uff08\u6319\u52d5\u304c\u5909\u308f\u308b\u53ef\u80fd\u6027\u304c\u3042\u308b\u305f\u3081\u3001\u5dee\u5206\u3092\u5fc5\u305a\u78ba\u8a8d\u3059\u308b\uff09\u3002<\/p>\n<pre class=\"lang:default decode:true\">ruff check . --fix --unsafe-fixes<\/pre>\n<h2>Format \u3092\u5b9f\u884c\u3059\u308b<\/h2>\n<p>Ruff \u306e Formatter \u306f <code>black<\/code> \u4e92\u63db\u3092\u610f\u8b58\u3057\u305f\u6574\u5f62\u3092\u884c\u3046\u3002<\/p>\n<pre class=\"lang:default decode:true\"># \u6574\u5f62\u3092\u9069\u7528\u3059\u308b\nruff format .\n\n# \u6574\u5f62\u304c\u5fc5\u8981\u304b\u3069\u3046\u304b\u3060\u3051\u30c1\u30a7\u30c3\u30af\uff08CI \u5411\u3051\u30fb\u66f8\u304d\u63db\u3048\u3057\u306a\u3044\uff09\nruff format . --check\n\n# \u5dee\u5206\u3092\u8868\u793a\u3059\u308b\nruff format . --diff<\/pre>\n<p><code>--check<\/code> \u306f\u6574\u5f62\u304c\u5fc5\u8981\u306a\u30d5\u30a1\u30a4\u30eb\u304c\u3042\u308b\u3068\u7d42\u4e86\u30b3\u30fc\u30c9\u304c\u975e\u30bc\u30ed\u306b\u306a\u308b\u306e\u3067\u3001CI \u3067\u300c\u6574\u5f62\u3055\u308c\u3066\u3044\u306a\u3044\u30b3\u30fc\u30c9\u3092\u5f3e\u304f\u300d\u7528\u9014\u306b\u4f7f\u3048\u308b\u3002<\/p>\n<h2>\u8a2d\u5b9a\u30d5\u30a1\u30a4\u30eb\uff08pyproject.toml\uff09<\/h2>\n<p>\u8a2d\u5b9a\u306f <code>pyproject.toml<\/code> \u306b <code>[tool.ruff]<\/code> \u30bb\u30af\u30b7\u30e7\u30f3\u3068\u3057\u3066\u66f8\u304f\u306e\u304c\u57fa\u672c\u3002\u30d7\u30ed\u30b8\u30a7\u30af\u30c8\u30eb\u30fc\u30c8\u306b\u7f6e\u304f\u3002<\/p>\n<pre class=\"lang:default decode:true\">[tool.ruff]\ntarget-version = \"py311\"\nline-length = 100\nexclude = [\n    \".venv\",\n    \"migrations\",\n    \"__pycache__\",\n]\n\n[tool.ruff.lint]\nselect = [\n    \"E\",   # pycodestyle errors\n    \"F\",   # pyflakes\n    \"I\",   # isort\uff08import \u4e26\u3073\u66ff\u3048\uff09\n    \"UP\",  # pyupgrade\n    \"B\",   # flake8-bugbear\n]\nignore = [\n    \"E501\",  # line-too-long\uff08formatter \u306b\u4efb\u305b\u308b\u5834\u5408\uff09\n]\n\n[tool.ruff.lint.per-file-ignores]\n\"tests\/*\" = [\"F401\"]\n\n[tool.ruff.format]\nquote-style = \"double\"<\/pre>\n<p><code>select<\/code> \u3067\u30eb\u30fc\u30eb\u7fa4\u3092\u300c\u30d7\u30ec\u30d5\u30a3\u30c3\u30af\u30b9\u300d\u3067\u6307\u5b9a\u3059\u308b\u306e\u304c\u30dd\u30a4\u30f3\u30c8\u3002<code>E<\/code>\uff08pycodestyle\uff09\u3084 <code>F<\/code>\uff08pyflakes\uff09\u306f\u5b9a\u756a\u3001<code>I<\/code> \u3092\u5165\u308c\u308b\u3068 <code>isort<\/code> \u76f8\u5f53\u306e import \u6574\u5217\u304c Ruff \u3060\u3051\u3067\u5b8c\u7d50\u3059\u308b\u3002\u4f7f\u3048\u308b\u30eb\u30fc\u30eb\u4e00\u89a7\u306f <code>ruff linter<\/code> \u3067\u78ba\u8a8d\u3067\u304d\u308b\u3002<\/p>\n<pre class=\"lang:default decode:true\"># \u6709\u52b9\u5316\u3067\u304d\u308b\u30eb\u30fc\u30eb\u7fa4\u306e\u4e00\u89a7\nruff linter\n\n# \u7279\u5b9a\u30eb\u30fc\u30eb\u306e\u8aac\u660e\u3092\u898b\u308b\nruff rule F401<\/pre>\n<h2>Lint \u3068 Format \u3092\u307e\u3068\u3081\u3066\u56de\u3059<\/h2>\n<p>\u666e\u6bb5\u306e\u958b\u767a\u3067\u306f\u3001\u6b21\u306e 2 \u30b3\u30de\u30f3\u30c9\u3092\u7d9a\u3051\u3066\u5b9f\u884c\u3059\u308b\u306e\u304c\u57fa\u672c\u5f62\u3002<\/p>\n<pre class=\"lang:default decode:true\">ruff check . --fix\nruff format .<\/pre>\n<p>\u9806\u756a\u306f\u300c\u5148\u306b Lint \u4fee\u6b63 \u2192 \u5f8c\u3067 Format\u300d\u304c\u7121\u96e3\u3002Lint \u306e <code>--fix<\/code> \u3067\u30b3\u30fc\u30c9\u69cb\u9020\u304c\u5909\u308f\u3063\u305f\u5f8c\u306b\u6574\u5f62\u3092\u304b\u3051\u308b\u3068\u3001\u6700\u7d42\u7684\u306a\u30ec\u30a4\u30a2\u30a6\u30c8\u304c\u5b89\u5b9a\u3059\u308b\u3002<\/p>\n<p>Makefile \u306b\u307e\u3068\u3081\u3066\u304a\u304f\u3068\u904b\u7528\u304c\u697d\u306b\u306a\u308b\u3002<\/p>\n<pre class=\"lang:default decode:true\">.PHONY: lint check\n\nlint:\n\truff check . --fix\n\truff format .\n\ncheck:\n\truff check .\n\truff format . --check<\/pre>\n<h2>pre-commit \u3068\u306e\u9023\u643a<\/h2>\n<pre class=\"lang:default decode:true\">repos:\n  - repo: https:\/\/github.com\/astral-sh\/ruff-pre-commit\n    rev: v0.6.9  # \u5b9f\u969b\u306e\u6700\u65b0\u30bf\u30b0\u306b\u5408\u308f\u305b\u308b\n    hooks:\n      - id: ruff\n        args: [--fix]\n      - id: ruff-format<\/pre>\n<pre class=\"lang:default decode:true\">pip install pre-commit\npre-commit install\npre-commit run --all-files<\/pre>\n<p>\u3053\u308c\u3067\u30b3\u30df\u30c3\u30c8\u306e\u305f\u3073\u306b Lint + Format \u304c\u81ea\u52d5\u3067\u5f53\u305f\u308b\u3002<\/p>\n<h2>CI \u3067\u306e\u78ba\u8a8d\u65b9\u6cd5<\/h2>\n<p>CI \u3067\u306f\u300c\u4fee\u6b63\u300d\u3067\u306f\u306a\u304f\u300c\u691c\u67fb\u300d\u3092\u884c\u3044\u3001\u6574\u5f62\u30fbLint \u9055\u53cd\u304c\u3042\u308c\u3070\u5931\u6557\u3055\u305b\u308b\u3002GitHub Actions \u306e\u4f8b\u3002<\/p>\n<pre class=\"lang:default decode:true\">name: lint\n\non: [push, pull_request]\n\njobs:\n  ruff:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions\/checkout@v4\n      - uses: actions\/setup-python@v5\n        with:\n          python-version: \"3.11\"\n      - run: pip install ruff\n      - run: ruff check .\n      - run: ruff format . --check<\/pre>\n<p><code>ruff check .<\/code>\uff08<code>--fix<\/code> \u306a\u3057\uff09\u3068 <code>ruff format . --check<\/code> \u306f\u3001\u3044\u305a\u308c\u3082\u9055\u53cd\u304c\u3042\u308b\u3068\u7d42\u4e86\u30b3\u30fc\u30c9\u304c\u975e\u30bc\u30ed\u306b\u306a\u308b\u305f\u3081\u3001\u305d\u306e\u307e\u307e CI \u306e\u5408\u5426\u306b\u4f7f\u3048\u308b\u3002<\/p>\n<h2>\u78ba\u8a8d\u65b9\u6cd5<\/h2>\n<pre class=\"lang:default decode:true\">ruff --version\n\necho \"import os\" &gt; \/tmp\/sample.py\nruff check \/tmp\/sample.py\n# -&gt; F401 [*] `os` imported but unused \u304c\u51fa\u308c\u3070 OK<\/pre>\n<h2>\u6ce8\u610f\u70b9<\/h2>\n<ul>\n<li><strong>\u30d0\u30fc\u30b8\u30e7\u30f3\u5dee\u3067\u30eb\u30fc\u30eb\u3084\u30c7\u30d5\u30a9\u30eb\u30c8\u304c\u5909\u308f\u308b<\/strong>\u3002\u7279\u306b Formatter \u306f 0.x \u7cfb\u3067\u3082\u6319\u52d5\u304c\u66f4\u65b0\u3055\u308c\u308b\u3053\u3068\u304c\u3042\u308b\u305f\u3081\u3001<code>ruff --version<\/code> \u3092 CI\u30fbpre-commit\u30fb\u30ed\u30fc\u30ab\u30eb\u3067\u63c3\u3048\u308b\u3002<\/li>\n<li><strong><code>select<\/code> \u3092\u660e\u793a\u3057\u306a\u3044\u3068\u30c7\u30d5\u30a9\u30eb\u30c8\u30eb\u30fc\u30eb\uff08<code>E<\/code> + <code>F<\/code> \u76f8\u5f53\uff09\u306e\u307f<\/strong>\u3002isort \u76f8\u5f53\uff08<code>I<\/code>\uff09\u3084 pyupgrade\uff08<code>UP<\/code>\uff09\u3092\u52b9\u304b\u305b\u305f\u3044\u306a\u3089\u660e\u793a\u7684\u306b\u8ffd\u52a0\u3059\u308b\u3002<\/li>\n<li><strong>\u65e2\u5b58\u30d7\u30ed\u30b8\u30a7\u30af\u30c8\u3078\u306e\u5c0e\u5165\u306f\u6bb5\u968e\u7684\u306b<\/strong>\u3002\u3044\u304d\u306a\u308a\u5168\u30eb\u30fc\u30eb\u3092\u6709\u52b9\u5316\u3059\u308b\u3068\u5dee\u5206\u304c\u81a8\u5927\u306b\u306a\u308b\u3002\u307e\u305a <code>ruff format<\/code> \u3067\u6574\u5f62\u3092\u901a\u3057\u3001Lint \u306f <code>select<\/code> \u3092\u5c11\u3057\u305a\u3064\u5897\u3084\u3059\u306e\u304c\u73fe\u5b9f\u7684\u3002<\/li>\n<li><code>black<\/code> \/ <code>isort<\/code> \/ <code>flake8<\/code> \u304b\u3089\u79fb\u884c\u3059\u308b\u5834\u5408\u3001<code>--fix<\/code> \u3068 <code>format<\/code> \u3067\u5927\u91cf\u306e\u5dee\u5206\u304c\u51fa\u308b\u306e\u3067\u3001\u5c02\u7528\u306e\u30b3\u30df\u30c3\u30c8\u306b\u5206\u3051\u3066\u30ec\u30d3\u30e5\u30fc\u3057\u3084\u3059\u304f\u3059\u308b\u3002<\/li>\n<\/ul>\n<h2>\u307e\u3068\u3081<\/h2>\n<p>Ruff \u3092\u5c0e\u5165\u3059\u308b\u3068\u3001<code>flake8<\/code> + <code>isort<\/code> + <code>black<\/code> \u306e\u5f79\u5272\u3092 1 \u3064\u306e\u30c4\u30fc\u30eb\u306b\u96c6\u7d04\u3067\u304d\u3001\u8a2d\u5b9a\u306f <code>pyproject.toml<\/code> \u306b\u4e00\u672c\u5316\u3067\u304d\u308b\u3002\u65e5\u5e38\u306f <code>ruff check . --fix &amp;&amp; ruff format .<\/code>\u3001CI \u306f <code>ruff check .<\/code> \u3068 <code>ruff format . --check<\/code> \u306e\u7d44\u307f\u5408\u308f\u305b\u304c\u57fa\u672c\u5f62\u306b\u306a\u308b\u3002\u901f\u5ea6\u3082\u901f\u304f\u3001\u65e2\u5b58\u30c4\u30fc\u30eb\u304b\u3089\u306e\u79fb\u884c\u30b3\u30b9\u30c8\u3082\u5c0f\u3055\u3044\u306e\u3067\u3001\u65b0\u898f\u30fb\u65e2\u5b58\u554f\u308f\u305a\u8a66\u3059\u4fa1\u5024\u304c\u3042\u308b\u3002<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Python \u306e Lint \u3068 Format \u306f\u3001\u9577\u3089\u304f flake8 \/ isort \/ black \u306a\u3069\u3092\u7d44\u307f\u5408\u308f\u305b\u308b\u306e\u304c\u5b9a\u756a\u3060\u3063\u305f\u3002\u30c4\u30fc\u30eb\u3054\u3068\u306b\u8a2d\u5b9a\u30d5\u30a1\u30a4\u30eb\u304c\u5206\u304b\u308c\u3001\u5b9f\u884c\u3082\u5225\u3005\u3067\u3001CI \u306e\u30b9\u30c6\u30c3\u30d7\u3082\u5897\u3048\u308b\u3002<\/p>\n","protected":false},"author":1,"featured_media":3429,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"sns_share_botton_hide":"","vkExUnit_sns_title":"","_vk_print_noindex":"","sitemap_hide":"","_veu_custom_css":"","veu_display_promotion_alert":"","vkexunit_cta_each_option":"","_lightning_design_setting":[],"_jetpack_hide_featured_image":false,"_jetpack_featured_image_duplicate_dismissed":0,"_jetpack_feature_clip_id":0,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":false,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2},"jetpack_post_was_ever_published":false},"categories":[38],"tags":[147],"class_list":["post-3430","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-python-memorandum","tag-python"],"veu_head_title_object":{"title":"","add_site_title":""},"jetpack_publicize_connections":[],"jetpack-related-posts":[],"jetpack_sharing_enabled":true,"jetpack_featured_media_url":"https:\/\/qol-kk.com\/wp2\/wp-content\/uploads\/2026\/09\/20260922-plan037-thumbnail.jpg","_links":{"self":[{"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/posts\/3430","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/comments?post=3430"}],"version-history":[{"count":1,"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/posts\/3430\/revisions"}],"predecessor-version":[{"id":3445,"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/posts\/3430\/revisions\/3445"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/media\/3429"}],"wp:attachment":[{"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/media?parent=3430"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/categories?post=3430"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/qol-kk.com\/wp2\/wp-json\/wp\/v2\/tags?post=3430"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}