Skip to content

ak110/pyfltr

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

497 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

pyfltr: Python Formatters, Linters, and Testers Runner

CI PyPI version

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コマンドの「コーディングエージェント連携」を参照。

ドキュメント

About

pyfltr: Python Formatters, Linters, and Testers Runner.

Resources

License

Stars

Watchers

Forks

Contributors

Languages