otsutil

よく使う関数やクラスを纏めたライブラリです。

このライブラリは以下の環境で作成・最適化されています。 Windows10/11, Python 3.12.0+

インストール

インストール pip install otsutil

アップデート pip install -U otsutil

アンインストール pip uninstall otsutil

モジュール

以下のモジュールが存在します。

モジュール名	概要
cfg	定数
classes	スレッドセーフなコンテナやタイマーなどのクラス定義
exceptions	例外
funcs	ファイル操作や型判定などの便利な関数定義
types	パッケージ全体で共通利用する型ヒント・ジェネリクス共通定義

cfgモジュール

cfgモジュールでは以下の定数が定義されています。

定数名	概要
JST	日本のタイムゾーン。

classesモジュール

classesモジュールでは以下のクラスが定義されています。

名称	概要
LockableDict	要素の操作時に `threading.RLock` を使用するスレッドセーフな `dict` クラス。 `with obj:` 構文によるコンテキストマネージャに対応し、複数の操作をアトミックに実行可能です。
LockableList	要素の操作時に `threading.RLock` を使用するスレッドセーフな `list` クラス。 `with obj:` 構文によるコンテキストマネージャに対応し、複数の操作をアトミックに実行可能です。
ObjectStore	オブジェクトを `pickle` + `base64` でシリアライズし、ファイルに永続化・管理するクラス。カスタムクラスを保存する場合、そのクラスに `__reduce__` を実装することでリスト内の要素なども含め高度な変換・復元が可能です。
OtsuNone	`None` を返す可能性のある辞書の `get` デフォルト値などに使用するセンチネルオブジェクト。 `bool()` 判定では `False` を返します。
Timer	指定時間の経過判定および待機を行うタイマー。同期的なブロック待機 (`join`) に加え、`asyncio` による非同期待機 (`ajoin`) をサポート。 `for` / `async for` 文で残り時間を `yield` しながら処理を行うイテレータ機能を持ちます。

exceptionsモジュール

exceptionsモジュールでは以下の例外が定義されています。

例外名	概要
PathError	パスに関連する例外の基底クラス
PathTypeError	パスの形式や型に関連するエラー（`PathError`を継承）
ObjectStoreError	ObjectStore関連処理で発生する基底例外クラス
ObjectStoreSaveError	オブジェクトの保存に失敗した際に送出される例外
ObjectStoreLoadError	オブジェクトの読み込みに失敗した際に送出される例外

funcsモジュール

funcsモジュールでは以下の関数が定義されています。

関数名	概要
deduplicate	シーケンスから重複を取り除き、順序を保持したまま元の型（`list`/`tuple`）で返す。
get_sub_paths	ディレクトリ内を探索し、ワイルドカードや拡張子による高度なフィルタリングを適用して子パスを一覧取得する。
is_all_type	反復可能オブジェクトの全ての要素が、指定した型であるか判定する。
is_dict_key_type	`dict[K, Any]`か検証する。
is_dict_type	`dict[K, V]`か検証する。
is_dict_value_type	`dict[K, V]`か検証する。
is_type	オブジェクトが指定した型であるか判定する（`None` 許容判定などを含む）。
iter_sub_paths	`get_sub_paths`のイテレータ版。
load_json	`JSON` ファイルを読み込む。親ディレクトリがない場合は作成し、ファイルがない場合はデフォルト値を返します。
read_lines	ファイルを1行ずつ読み出すジェネレータ。改行コードの自動除去やエンコーディング指定が可能です。
same_path	パス群が（相対/絶対に関わらず）物理的に同じ場所を指しているか判定する。
save_json	オブジェクトを `JSON` 形式で保存する。
setup_path	パスを `Path` オブジェクトとして整備し、必要に応じて親ディレクトリを生成して利用可能な状態にする。
str_to_path	文字列を `pathlib.Path` に変換する。
write_lines	反復可能な文字列データを1行ずつファイルに書き出す。

typesモジュール

typesモジュールでは、Python 3.12 のジェネリクス構文に対応した以下の型定義がされています。

名称	概要
ExpectType[T]	`isinstance(obj, ExpectType)`で使用できる型。
FloatInt	`float` または `int` に限定した数値型。
HMSTuple	`(時, 分, 秒)` のタプル。型は `(int, int, float)`。
OptPath	`pathlib.Path` または`None`
OptStr	`str` または`None`。
OptStrPath	`pathlib.Path`または`str`または`None`。
StrPath	`pathlib.Path` または `str`。

Metadata

Release files for otsutil 1.3.11.312

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for otsutil 1.3.11.312
File	Size	Uploaded
otsutil-1.3.11.312.tar.gz	19.7 kB	Sep 30, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for otsutil 1.3.11.312
File	Interpreter	ABI	Platform	Reset
otsutil-1.3.11.312-py3-none-any.whl 16.0 kB Sep 30, 2026	Python 3	none	any	Details

Total release size: 35.6 kB

Release files / otsutil-1.3.11.312.tar.gz

Download URL	otsutil-1.3.11.312.tar.gz
Size	19.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`a3baac3623098c94cdb717bc14910ca429d8945ae69e346fabb8ffdfc3690eac`
BLAKE2b-256 checksum How to use checksums	`ba8a6d64c774a1f6b491d851a90979f7b774fd60c15fc6ac9dda5f9adf71f473`
Upload date	Sep 30, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.15`

Release files / otsutil-1.3.11.312-py3-none-any.whl

Download URL	otsutil-1.3.11.312-py3-none-any.whl
Size	16.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`41196360e23faa445ddb39f05c2471dc49e68fd505590605b432e20ca65ec099`
BLAKE2b-256 checksum How to use checksums	`2e708a6cc2c2037d5cd42a793772217bdff2f22feea423a70574b7f418e9dbfc`
Upload date	Sep 30, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.15`