CLIコマンド¶

一部機能はCLIから利用できる。

uvxから起動する場合¶

uvx pytilpackはベースパッケージのみで起動する。 mcpやfetchはベース依存で動作するためそのまま実行できる。 wait-for-db-connectionやbabelのように追加依存を必要とするサブコマンドは--fromで必要なextrasを明示する。

uvx pytilpack mcp
uvx pytilpack fetch https://example.com/
uvx --from='pytilpack[sqlalchemy]' pytilpack wait-for-db-connection "$SQLALCHEMY_DATABASE_URI"
uvx --from='pytilpack[babel]' pytilpack babel extract .

extrasが足りない状態で該当サブコマンドを呼ぶと、必要なextras名を含むエラーメッセージが表示される。

空のディレクトリを削除¶

pytilpack delete-empty-dirs path/to/dir [--no-keep-root] [--verbose]

空のディレクトリを削除する。デフォルトでルートディレクトリを保持する。

古いファイルを削除¶

pytilpack delete-old-files path/to/dir --days=7 [--no-delete-empty-dirs] [--verbose]

指定した日数より古いファイルを削除する。デフォルトで空ディレクトリも削除する。

ディレクトリを同期¶

pytilpack sync src dst [--delete] [--verbose]

コピー元からコピー先へファイル・ディレクトリを同期する。 --deleteでコピー元に存在しないコピー先のファイル・ディレクトリを削除する。

URLの内容を取得¶

pytilpack fetch url [--no-verify] [--accept=CONTENT_TYPE] [--user-agent=USER_AGENT] [--verbose]

URLからHTMLを取得し、簡略化して標準出力に出力する。

MCPサーバーを起動¶

pytilpack mcp [--transport=stdio|http] [--host=localhost] [--port=8000] [--verbose]

Model Context ProtocolサーバーとしてpytilpackのFetch機能を提供する。 --transportでstdio（デフォルト）またはhttp通信方式を選択できる。

Babelメッセージ管理¶

pytilpack babel extract input_dirs... [-o messages.pot] [-k KEYWORDS...]
pytilpack babel init -l LOCALE [-i messages.pot] [-d locales]
pytilpack babel update [-i messages.pot] [-d locales]
pytilpack babel compile [-d locales]

gettextメッセージの抽出・初期化・更新・コンパイルを行う。

DB接続待機¶

pytilpack wait-for-db-connection SQLALCHEMY_DATABASE_URI [--timeout=180] [--verbose]

指定URIでDB接続が可能になるまで待機する（デフォルトタイムアウト: 180秒）。非同期ドライバ（+asyncpg、+aiosqlite等）を含むURIの場合は自動で非同期処理を使用する。