pytilpack 1.31.0

Python Utility Pack

pytilpack

Pythonの各種ライブラリのユーティリティ集。

インストール

pip install pytilpack
# pip install pytilpack[all]
# pip install pytilpack[fastapi]
# pip install pytilpack[flask]
# pip install pytilpack[markdown]
# pip install pytilpack[openai]
# pip install pytilpack[pyyaml]
# pip install pytilpack[quart]
# pip install pytilpack[sqlalchemy]
# pip install pytilpack[tiktoken]
# pip install pytilpack[tqdm]

使い方

import

各モジュールを個別にimportして利用する。

import pytilpack.xxx

xxxのところは対象ライブラリと同名になっている。openaiとかpathlibとか。 それぞれのモジュールに関連するユーティリティ関数などが入っている。

特定のライブラリに依存しないものもある。

モジュール一覧

各種ライブラリ用のユーティリティのモジュール一覧

• pytilpack.asyncio
• pytilpack.base64
• pytilpack.csv
• pytilpack.dataclasses
• pytilpack.datetime
• pytilpack.fastapi
• pytilpack.flask
• pytilpack.flask_login
• pytilpack.functools
• pytilpack.json
• pytilpack.logging
• pytilpack.openai
• pytilpack.pathlib
• pytilpack.pycrypto
• pytilpack.python
• pytilpack.quart
• pytilpack.sqlalchemy
• pytilpack.sqlalchemya # asyncio版
• pytilpack.threading
• pytilpack.threadinga # asyncio版
• pytilpack.tiktoken
• pytilpack.tqdm
• pytilpack.typing
• pytilpack.yaml

その他のユーティリティのモジュール一覧

• pytilpack.cache # ファイルキャッシュ関連
• pytilpack.data_url # データURL関連
• pytilpack.healthcheck # ヘルスチェック処理関連
• pytilpack.htmlrag # HtmlRAG関連
• pytilpack.sse # Server-Sent Events関連
• pytilpack.web # Web関連

CLIコマンド

一部の機能はCLIコマンドとしても利用可能。

空のディレクトリを削除

pytilpack delete_empty_dirs path/to/dir [--no-keep-root] [--verbose]

• 空のディレクトリを削除
• デフォルトでルートディレクトリを保持（--no-keep-rootで削除可能）

古いファイルを削除

pytilpack delete_old_files path/to/dir --days=7 [--no-delete-empty-dirs] [--no-keep-root-empty-dir] [--verbose]

• 指定した日数より古いファイルを削除（--daysオプションで指定）
• デフォルトで空ディレクトリを削除（--no-delete-empty-dirsで無効化）
• デフォルトでルートディレクトリを保持（--no-keep-root-empty-dirで削除可能）

ディレクトリを同期

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

• コピー元(src)からコピー先(dst)へファイル・ディレクトリを同期
• 日付が異なるファイルをコピー
• --deleteオプションでコピー元に存在しないコピー先のファイル・ディレクトリを削除

URLの内容を取得

pytilpack fetch url [--no-verify] [--verbose]

• URLからHTMLを取得し、簡略化して標準出力に出力
• --no-verifyオプションでSSL証明書の検証を無効化
• --verboseオプションで詳細なログを出力

MCPサーバーを起動

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

• Model Context ProtocolサーバーとしてpytilpackのFetch機能を提供
• --transportオプションで通信方式を指定（stdio/http、デフォルト: stdio）
• --hostオプションでサーバーのホスト名を指定（httpの場合のみ使用、デフォルト: localhost）
• --portオプションでサーバーのポート番号を指定（httpの場合のみ使用、デフォルト: 8000）
• --verboseオプションで詳細なログを出力

stdioモード（推奨）

pytilpack mcp
# または
pytilpack mcp --transport=stdio

標準入力/出力を使用してMCPクライアント（Claude Desktop等）と通信します。

httpモード

pytilpack mcp --transport=http --port=8000

HTTPサーバーとして起動し、指定されたポートでMCPクライアントからの接続を待ちます。

開発手順

• DEVELOPMENT.md を参照