Python Formatters, Linters, and Testers Runner.
Project description
pyfltr: Python Formatters, Linters, and Testers Runner
Python / Rust / .NET / TypeScript・JavaScript / ドキュメントなど多言語プロジェクトの formatter・linter・testerを単一コマンドで並列実行するCLIツール。 （要Python 3.11以上）
特徴
- formatter・linter・testerをまとめて呼び出す
- 複数ツールの並列実行による総実行時間の短縮
- コーディングエージェント向けJSON Lines出力（
--output-format=jsonl） - 設定の集約:
pyproject.tomlに集約した統一設定 - 除外指定（exclude）の書式差をツール間で吸収
- 横断検索（
grep）と置換（replace、世代管理付き--undo対応） - MCPサーバー（
pyfltr mcp） - シェル補完スクリプト生成
インストール
uvx pyfltrで実行する。事前インストールやdev依存への追加なしで最新版を取得して実行する。
uvx pyfltr --help
uvでバージョン管理する場合はuv add --dev pyfltrまたはuv add --dev "pyfltr[python]"で追加し、
uv run pyfltr ...で呼び出す。
pip環境ではpip install pyfltrを使う。
実行するツールはpyproject.tomlの[tool.pyfltr]セクションで指定する。
段階的な導入手順ははじめにを参照。
使い方
チェック実行（ci / run / fast）・エージェント向け出力（run-for-agent）・横断検索と置換（grep / replace）など。
実行履歴参照（list-runs / show-run）・設定操作（config）・MCPサーバー（mcp）も利用できる。
詳細はCLIコマンドを参照。
コーディングエージェント向け
pyfltr run-for-agentをエージェントから直接呼び出すか、pyfltr mcpでMCPサーバーとして登録する。
# 直接呼び出し（JSONL出力）
uvx pyfltr run-for-agent
# MCPサーバーとして登録（Claude Code例）
claude mcp add pyfltr -- uvx pyfltr mcp
詳細はCLIコマンドの「コーディングエージェント連携」を参照。
ドキュメント
- https://ak110.github.io/pyfltr/ — はじめに・対応ツール一覧・設定リファレンス
- https://ak110.github.io/pyfltr/llms.txt — LLM向け構造化インデックス
- docs/development/development.md — 開発者向け情報
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file pyfltr-3.12.0.tar.gz.
File metadata
- Download URL: pyfltr-3.12.0.tar.gz
- Upload date:
- Size: 611.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.15 {"installer":{"name":"uv","version":"0.11.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5a1af2050ff171f339086b5776337e8d02ed83bf6fd512bcf40dfb7fe93f3e68
|
|
| MD5 |
88360418def57f0572f379311e3ad8e5
|
|
| BLAKE2b-256 |
c61a1258e372723b22b7c06e7af9a9bf9c74c29474329bafaaefe3b6c94bd864
|
File details
Details for the file pyfltr-3.12.0-py3-none-any.whl.
File metadata
- Download URL: pyfltr-3.12.0-py3-none-any.whl
- Upload date:
- Size: 281.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.15 {"installer":{"name":"uv","version":"0.11.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f472e753be8f814459e440cc3600f591db4c94b809149fc016b8cfa068552252
|
|
| MD5 |
dae09c7f617c2731cfc716c6a6928b85
|
|
| BLAKE2b-256 |
162222eb00f2ac9518ef22f60a3b49d3982f549cb6feac0ffdcdac4b5ec3f4c8
|
