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）の書式差をツール間で吸収
- MCPサーバー（
pyfltr mcp） - シェル補完スクリプト生成
インストール
uv利用時の推奨は、毎回最新版を解決して実行するwith方式である。 事前のインストールやdev依存への追加は不要で、常に最新のpyfltrを使える。
uv run --with="pyfltr[python]" pyfltr --help
pyfltr[python]はPython系ツール（ruff-format / ruff-check / mypy / pylint / pyright /
ty / pytest / uv-sort）の追加依存を含むextras指定。
このうちtyのみpreset非収録のため、必要に応じてty = trueを個別指定する。
dev依存に固定したい場合はuv add --dev 'pyfltr[python]'で追加し、
通常通りuv run pyfltr ...で呼び出す。
pip環境ではpip install 'pyfltr[python]'を使う。
Python / JavaScript / Rust / .NETの各言語カテゴリに属するツールはすべて既定で無効（opt-in）である。
preset = "latest" + 言語カテゴリキー（python / javascript / rust / dotnet）のtrue指定だけで、
当該言語の推奨ツール一式が有効化される。
archive保持期間やキャッシュ設定など複数プロジェクトで共通にしたい設定は、
グローバル設定ファイル（Linux: ~/.config/pyfltr/config.toml）に集約できる。
詳細は設定項目および
グローバル設定を参照。
使い方
uvx pyfltr --help
uvxでの実行も可能。
主なサブコマンド
pyfltr ci/run/fast— チェック実行（CI / ローカル全体 / 軽量）pyfltr run-for-agent— エージェント向け（runの出力形式の既定値をjsonlに切り替えたサブコマンド）pyfltr list-runs/show-run— 実行履歴の参照pyfltr config— 設定ファイルの操作（get/set/delete/list）pyfltr command-info— ツール起動方式の確認pyfltr 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.7.3.tar.gz.
File metadata
- Download URL: pyfltr-3.7.3.tar.gz
- Upload date:
- Size: 448.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","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 |
412e9f0a6dcb37bd84f443883343f627ef1fbc68650ca044d795453c7d4e09ae
|
|
| MD5 |
9683da7ae68b1a8dafc6f8cdfce8303c
|
|
| BLAKE2b-256 |
076b8194a0cb50cc7a7ac5fc6619f063357cb157b9304a692096119d0560f2dd
|
File details
Details for the file pyfltr-3.7.3-py3-none-any.whl.
File metadata
- Download URL: pyfltr-3.7.3-py3-none-any.whl
- Upload date:
- Size: 193.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","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 |
e3969cefd68011baf938eb2c3ec47c8ae3cc445497243e7cbd047fa712f00665
|
|
| MD5 |
9ec6a78bdec1c3fe8e48cb380fe4e77e
|
|
| BLAKE2b-256 |
436f07b60c006661a256caa0dec59cde1f32cd99442c24ad58fb967744057f71
|
