pytilpack 1.42.1

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.fnctl
• pytilpack.functools
• pytilpack.httpx
• pytilpack.importlib
• 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.http: HTTP関連
• pytilpack.io: IO関連のユーティリティ
• pytilpack.jsonc: JSON with Comments関連
• pytilpack.paginator: ページネーション関連
• 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

httpモード

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

DB接続待機

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

• 指定されたSQLALCHEMY_DATABASE_URIでDBに接続可能になるまで待機
• URLに非同期ドライバ（+asyncpg, +aiosqlite, +aiomysql等）が含まれる場合は自動で非同期処理を使用
• --timeoutオプションでタイムアウト秒数を指定（デフォルト: 180）
• --verboseオプションで詳細なログを出力

開発手順

• DEVELOPMENT.md を参照