# pytilpack

> Pythonのユーティリティ集

Python 3.12以上が必要。コア依存: beautifulsoup4, httpx, mcp, werkzeug。

## インストール

```bash
pip install pytilpack
```

オプション依存: `pytilpack[all]`, `pytilpack[babel]`, `pytilpack[bleach]`, `pytilpack[environ]`, `pytilpack[fastapi]`, `pytilpack[flask]`, `pytilpack[markdown]`, `pytilpack[msal]`, `pytilpack[pycryptodome]`, `pytilpack[pydantic]`, `pytilpack[pytest]`, `pytilpack[pyyaml]`, `pytilpack[quart]`, `pytilpack[sqlalchemy]`, `pytilpack[tiktoken]`, `pytilpack[tqdm]`, `pytilpack[web]`

## 主な使い方

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

```python
import pytilpack.xxx
```

`xxx` には対象ライブラリ名（`httpx` や `pathlib` など）が入る。


## ドキュメント

- [ホーム](https://ak110.github.io/pytilpack/index.md): ドキュメント入口
- [概要](https://ak110.github.io/pytilpack/guide/index.md): インストール・extras一覧・モジュール一覧
- [CLIコマンド](https://ak110.github.io/pytilpack/guide/cli/index.md): CLIコマンド

## ライブラリ用ユーティリティ

- [pytilpack.asyncio](https://ak110.github.io/pytilpack/api/asyncio/index.md): 非同期I/O、ジョブランナー、スレッドプール
- [pytilpack.babel](https://ak110.github.io/pytilpack/api/babel/index.md): Babel多言語メッセージ管理
- [pytilpack.base64](https://ak110.github.io/pytilpack/api/base64/index.md): Base64エンコードとデコード
- [pytilpack.cli](https://ak110.github.io/pytilpack/api/cli/index.md): CLIコマンド
- [pytilpack.csv](https://ak110.github.io/pytilpack/api/csv/index.md): CSV読み書き
- [pytilpack.dataclasses](https://ak110.github.io/pytilpack/api/dataclasses/index.md): dataclass操作
- [pytilpack.datetime](https://ak110.github.io/pytilpack/api/datetime/index.md): 日時ユーティリティ
- [pytilpack.fastapi](https://ak110.github.io/pytilpack/api/fastapi/index.md): FastAPIアサーション、i18n
- [pytilpack.flask](https://ak110.github.io/pytilpack/api/flask/index.md): Flaskアサーション、プロキシー修正
- [pytilpack.flask_login](https://ak110.github.io/pytilpack/api/flask_login/index.md): Flask-Login拡張
- [pytilpack.fnctl](https://ak110.github.io/pytilpack/api/fnctl/index.md): ファイルロック
- [pytilpack.functools](https://ak110.github.io/pytilpack/api/functools/index.md): retryデコレータ、キャッシュ
- [pytilpack.httpx](https://ak110.github.io/pytilpack/api/httpx/index.md): httpx拡張
- [pytilpack.importlib](https://ak110.github.io/pytilpack/api/importlib/index.md): 動的モジュールインポート
- [pytilpack.json](https://ak110.github.io/pytilpack/api/json/index.md): JSON読み書き
- [pytilpack.logging](https://ak110.github.io/pytilpack/api/logging/index.md): ロギング設定、ログチェッカー
- [pytilpack.markdown](https://ak110.github.io/pytilpack/api/markdown/index.md): Markdownレンダリング
- [pytilpack.msal](https://ak110.github.io/pytilpack/api/msal/index.md): Microsoft認証(MSAL/Entra ID)
- [pytilpack.pathlib](https://ak110.github.io/pytilpack/api/pathlib/index.md): パス操作拡張
- [pytilpack.pycrypto](https://ak110.github.io/pytilpack/api/pycrypto/index.md): AES-GCM暗号化
- [pytilpack.pydantic](https://ak110.github.io/pytilpack/api/pydantic/index.md): Pydantic v2ユーティリティ
- [pytilpack.pytest](https://ak110.github.io/pytilpack/api/pytest/index.md): テスト用アサーション
- [pytilpack.python](https://ak110.github.io/pytilpack/api/python/index.md): 型変換、辞書マージ、None判定
- [pytilpack.quart](https://ak110.github.io/pytilpack/api/quart/index.md): Quartアサーション、i18n
- [pytilpack.quart_auth](https://ak110.github.io/pytilpack/api/quart_auth/index.md): Quart認証拡張
- [pytilpack.sqlalchemy](https://ak110.github.io/pytilpack/api/sqlalchemy/index.md): 非同期ORM基盤、セッション管理
- [pytilpack.threading](https://ak110.github.io/pytilpack/api/threading/index.md): スレッド関連ユーティリティ
- [pytilpack.threadinga](https://ak110.github.io/pytilpack/api/threadinga/index.md): asyncio版スレッドユーティリティ
- [pytilpack.tiktoken](https://ak110.github.io/pytilpack/api/tiktoken/index.md): トークンカウント、画像処理
- [pytilpack.tqdm](https://ak110.github.io/pytilpack/api/tqdm/index.md): プログレスバー拡張
- [pytilpack.typing](https://ak110.github.io/pytilpack/api/typing/index.md): 型ヒント関連
- [pytilpack.yaml](https://ak110.github.io/pytilpack/api/yaml/index.md): YAML読み書き

## 汎用モジュール

- [pytilpack.cache](https://ak110.github.io/pytilpack/api/cache/index.md): ファイルキャッシュ関連
- [pytilpack.crypto](https://ak110.github.io/pytilpack/api/crypto/index.md): 署名・トークン関連
- [pytilpack.data_url](https://ak110.github.io/pytilpack/api/data_url/index.md): データURL関連
- [pytilpack.environ](https://ak110.github.io/pytilpack/api/environ/index.md): 環境変数関連
- [pytilpack.healthcheck](https://ak110.github.io/pytilpack/api/healthcheck/index.md): ヘルスチェック処理関連
- [pytilpack.htmlrag](https://ak110.github.io/pytilpack/api/htmlrag/index.md): HtmlRAG関連
- [pytilpack.http](https://ak110.github.io/pytilpack/api/http/index.md): HTTP関連
- [pytilpack.i18n](https://ak110.github.io/pytilpack/api/i18n/index.md): 国際化(i18n)関連
- [pytilpack.io](https://ak110.github.io/pytilpack/api/io/index.md): IO関連のユーティリティ
- [pytilpack.jsonc](https://ak110.github.io/pytilpack/api/jsonc/index.md): JSON with Comments関連
- [pytilpack.paginator](https://ak110.github.io/pytilpack/api/paginator/index.md): ページネーション関連
- [pytilpack.random](https://ak110.github.io/pytilpack/api/random/index.md): 疑似乱数関連
- [pytilpack.ratelimit](https://ak110.github.io/pytilpack/api/ratelimit/index.md): レートリミッター
- [pytilpack.secrets](https://ak110.github.io/pytilpack/api/secrets/index.md): シークレットキー関連
- [pytilpack.sse](https://ak110.github.io/pytilpack/api/sse/index.md): Server-Sent Events関連
- [pytilpack.validator](https://ak110.github.io/pytilpack/api/validator/index.md): バリデーション関連
- [pytilpack.web](https://ak110.github.io/pytilpack/api/web/index.md): Web関連