otsutil
よく使う関数やクラスを纏めたライブラリです。
このライブラリは以下の環境で作成・最適化されています。
Windows10/11, Python 3.12.0+
インストール
インストール
pip install otsutil
アップデート
pip install -U otsutil
アンインストール
pip uninstall otsutil
モジュール
以下のモジュールが存在します。
| モジュール名 | 概要 |
|---|---|
| classes | スレッドセーフなコンテナやタイマーなどのクラス定義 |
| funcs | ファイル操作や型判定などの便利な関数定義 |
| types | パッケージ全体で共通利用する型ヒント・ジェネリクス共通定義 |
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 しながら処理を行うイテレータ機能を持ちます。 |
funcsモジュール
funcsモジュールでは以下の関数が定義されています。
| 関数名 | 概要 |
|---|---|
| deduplicate | シーケンスから重複を取り除き、順序を保持したまま元の型（list/tuple）で返す。 |
| ensure_relative | パスを基準ディレクトリからの相対パスに確実に正規化する。環境依存の絶対パスを排除する際に有用。 |
| get_sub_paths | ディレクトリ内を探索し、ワイルドカードや拡張子による高度なフィルタリングを適用して子パスを一覧取得する。 |
| get_value | 階層構造を持つ辞書などから、キーのリストを指定して安全に値を取得する。 |
| is_all_type | 反復可能オブジェクトの全ての要素が、指定した型であるか判定する。 |
| is_type | オブジェクトが指定した型であるか判定する（None 許容判定などを含む）。 |
| load_json | JSON ファイルを読み込む。親ディレクトリがない場合は作成し、ファイルがない場合はデフォルト値を返します。 |
| read_lines | ファイルを1行ずつ読み出すジェネレータ。改行コードの自動除去やエンコーディング指定が可能です。 |
| same_path | 2つのパスが（相対/絶対に関わらず）物理的に同じ場所を指しているか判定する。 |
| save_json | オブジェクトを JSON 形式で保存する。 |
| setup_path | パスを Path オブジェクトとして整備し、必要に応じて親ディレクトリを生成して利用可能な状態にする。 |
| str_to_path | 文字列を pathlib.Path に変換する。 |
| write_lines | 反復可能な文字列データを1行ずつファイルに書き出す。 |
typesモジュール
typesモジュールでは、Python 3.12 のジェネリクス構文に対応した以下の型定義がされています。
| 名称 | 形式 | 概要 |
|---|---|---|
| FloatInt | TypeAlias | float または int に限定した数値型。 |
| K / V | TypeVar | 辞書のキー(Key)や値(Value)を想定した型変数。 |
| P | ParamSpec | 関数の引数仕様（Parameter Specification）を表す型変数。 |
| R | TypeVar | 関数の戻り値（Return Value）を表す型変数。 |
| T | TypeVar | 制約のない汎用的な型変数。 |
| HMSTuple | Alias | (時, 分, 秒) のタプル。型は (int, int, float)。 |
| StrPath | Alias | pathlib.Path または str。 |
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
otsutil-1.3.0.312.tar.gz
(12.8 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file otsutil-1.3.0.312.tar.gz.
File metadata
- Download URL: otsutil-1.3.0.312.tar.gz
- Upload date:
- Size: 12.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3105761c6a4ac51552818ee9e339a471a7a7e4c2133de6949af9c100b45b3fff
|
|
| MD5 |
e7dd7710731986175bca9ccac89442dd
|
|
| BLAKE2b-256 |
309d7235d9c13587640340784bebbf4e7413a3d446bbb2cd43c8fd2f541faf61
|
File details
Details for the file otsutil-1.3.0.312-py3-none-any.whl.
File metadata
- Download URL: otsutil-1.3.0.312-py3-none-any.whl
- Upload date:
- Size: 12.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1ba50b91ac00872e7f105d5dd7b05e0066ffde531df7e2e98b68b796d11d4a20
|
|
| MD5 |
d778d7f9c1d40286d187bbf1e7327463
|
|
| BLAKE2b-256 |
08cafd062e061a9c2702c77dcd79c73bf1244c0da108e23c1e27689ff6849406
|
