otsuvalidator 1.1.0.312__tar.gz

otsuvalidator-1.1.0.312/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 Otsuhachi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

otsuvalidator-1.1.0.312/PKG-INFO

@@ -0,0 +1,118 @@
+Metadata-Version: 2.4
+Name: otsuvalidator
+Version: 1.1.0.312
+Summary: A useful python package named otsuvalidator.
+Home-page: https://github.com/Otsuhachi/OtsuValidator
+Author: Otsuhachi
+Author-email: Otsuhachi <agequodagis.tufuiegoeris@gmail.com>
+License: MIT License
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+- [概要](#概要)
+  - [インストール](#インストール)
+  - [モジュール](#モジュール)
+    - [basesモジュールのクラス](#basesモジュールのクラス)
+    - [validatorsモジュールのクラス](#validatorsモジュールのクラス)
+    - [convertersモジュールのクラス](#convertersモジュールのクラス)
+  - [継承規則](#継承規則)
+    - [Validator継承規則](#validator継承規則)
+    - [VContainer継承規則](#vcontainer継承規則)
+    - [Converter継承規則](#converter継承規則)
+
+---
+# 概要
+
+このライブラリは、値の正常性を検証するバリデータ群と、検証前に型変換を試みるコンバータ群を提供するユーティリティです。  
+ディスクリプタとしてクラス属性に使用することで不適切な値の代入を防止できるほか、単独の関数・オブジェクトとして値を検証・変換することも可能です。
+
+---
+## インストール
+
+**インストール**
+```bash
+pip install otsuvalidator
+```
+
+**アップデート**
+```bash
+pip install -U otsuvalidator
+```
+
+**アンインストール**
+```bash
+pip uninstall otsuvalidator
+```
+
+## モジュール
+本ライブラリは主に以下の3つのモジュールで構成されています。
+
+モジュール名|概要
+:--:|:--:
+`bases`|バリデータ・コンバータの基底クラスを定義。自作のバリデータを作成する際に使用します。
+`validators`|値の検証のみを行うバリデータ群が定義されています。
+`converters`|型変換を試みた上で検証を行うコンバータ群が定義されています。
+
+
+### basesモジュールのクラス
+- `Validator`: すべてのバリデータおよびコンバータの基底クラス。
+- `VContainer`: コンテナ（リストや辞書など）用バリデータの基底クラス。要素が可変なオブジェクトを検証する際に使用します。
+- `Converter`: コンバータの基底クラス。
+- `VChain`: バリデータ・コンバータの連結をサポートします。
+
+### validatorsモジュールのクラス
+※破線されたクラスは非推奨です。
+クラス|概要|期待する型
+:--:|:--:|:--:
+VBool|真偽値オブジェクトか検証|bool
+VChoice|規定の選択肢の中から1つが選択されているか検証|Any
+VNumerical / ~~VNumber~~|適切な数値か検証|int / float
+VFloat|適切な浮動小数点数か検証|float
+VInt|適切な整数か検証|int
+VPath|適切なパスか検証|pathlib.Path
+VString|適切な文字列か検証|str
+~~VRegex~~|適切な正規表現か検証。`VString(pattern=...)`に合併。|str
+VDict|適切な構造の辞書か検証|dict
+VList|適切なリストか検証|list
+VTuple|適切なタプルか検証|tuple
+VTimedelta|適切なtimedelta型か検証|datetime.timedelta
+
+### convertersモジュールのクラス
+※破線されたクラスは非推奨です。
+クラス|概要
+:--:|:--:
+CBool|Yes / Noとして解釈できる値に対し`bool`型への変換を試みて検証
+CNumerical / ~~CNumber~~|`int` / `float`型への自動変換を試みて検証
+CFloat|`float`型への自動変換を試みて検証
+CInt|`int`型への自動変換を試みて検証
+CPath|`pathlib.Path`型への自動変換を試みて検証
+CString|`str`型への返還を試みて検証
+CTimedelta|`datetime.timedelta`型への自動変換を試みて検証
+
+## 継承規則
+自作のバリデータやコンバータを正しく定義するための規則です。
+
+### Validator継承規則
+1. 命名: クラス名は`V{検証したいクラス名}`とします（例: `VString`）。
+2. 継承: `Validator`クラスを継承します。
+3. 定義: `validate`メソッドを定義し、検証が成功した場合は受け取った`value`を返します。
+4. 変換: `validate`内で`value`の型変換を行ってはいけません（変換を行う場合は`Converter`を使用）。
+
+### VContainer継承規則
+1. 命名: クラス名は`V{検証したいクラス名}`とします（例: `VList`）。
+2. 継承: `VContainer`クラスを継承します。
+3. 定義: `validate`メソッドを定義し、検証通過時は`value`を返します。中身の各要素への検証規則を設定します。
+4. 変換: コンテナ自体の型変換は行いません。ただし要素に対してはオプション設定に応じます。
+
+### Converter継承規則
+1. 命名: `C{変換検証したいクラス名}`とします（例: `CInt`）。
+2. 継承: `（対象クラスのバリデータ, Converter）`の順で多重継承します。
+3. 定義: `validate`内で型変換を行い、`return super().validate(value)`で検証して返します。

otsuvalidator-1.1.0.312/README.md

@@ -0,0 +1,99 @@
+- [概要](#概要)
+  - [インストール](#インストール)
+  - [モジュール](#モジュール)
+    - [basesモジュールのクラス](#basesモジュールのクラス)
+    - [validatorsモジュールのクラス](#validatorsモジュールのクラス)
+    - [convertersモジュールのクラス](#convertersモジュールのクラス)
+  - [継承規則](#継承規則)
+    - [Validator継承規則](#validator継承規則)
+    - [VContainer継承規則](#vcontainer継承規則)
+    - [Converter継承規則](#converter継承規則)
+
+---
+# 概要
+
+このライブラリは、値の正常性を検証するバリデータ群と、検証前に型変換を試みるコンバータ群を提供するユーティリティです。  
+ディスクリプタとしてクラス属性に使用することで不適切な値の代入を防止できるほか、単独の関数・オブジェクトとして値を検証・変換することも可能です。
+
+---
+## インストール
+
+**インストール**
+```bash
+pip install otsuvalidator
+```
+
+**アップデート**
+```bash
+pip install -U otsuvalidator
+```
+
+**アンインストール**
+```bash
+pip uninstall otsuvalidator
+```
+
+## モジュール
+本ライブラリは主に以下の3つのモジュールで構成されています。
+
+モジュール名|概要
+:--:|:--:
+`bases`|バリデータ・コンバータの基底クラスを定義。自作のバリデータを作成する際に使用します。
+`validators`|値の検証のみを行うバリデータ群が定義されています。
+`converters`|型変換を試みた上で検証を行うコンバータ群が定義されています。
+
+
+### basesモジュールのクラス
+- `Validator`: すべてのバリデータおよびコンバータの基底クラス。
+- `VContainer`: コンテナ（リストや辞書など）用バリデータの基底クラス。要素が可変なオブジェクトを検証する際に使用します。
+- `Converter`: コンバータの基底クラス。
+- `VChain`: バリデータ・コンバータの連結をサポートします。
+
+### validatorsモジュールのクラス
+※破線されたクラスは非推奨です。
+クラス|概要|期待する型
+:--:|:--:|:--:
+VBool|真偽値オブジェクトか検証|bool
+VChoice|規定の選択肢の中から1つが選択されているか検証|Any
+VNumerical / ~~VNumber~~|適切な数値か検証|int / float
+VFloat|適切な浮動小数点数か検証|float
+VInt|適切な整数か検証|int
+VPath|適切なパスか検証|pathlib.Path
+VString|適切な文字列か検証|str
+~~VRegex~~|適切な正規表現か検証。`VString(pattern=...)`に合併。|str
+VDict|適切な構造の辞書か検証|dict
+VList|適切なリストか検証|list
+VTuple|適切なタプルか検証|tuple
+VTimedelta|適切なtimedelta型か検証|datetime.timedelta
+
+### convertersモジュールのクラス
+※破線されたクラスは非推奨です。
+クラス|概要
+:--:|:--:
+CBool|Yes / Noとして解釈できる値に対し`bool`型への変換を試みて検証
+CNumerical / ~~CNumber~~|`int` / `float`型への自動変換を試みて検証
+CFloat|`float`型への自動変換を試みて検証
+CInt|`int`型への自動変換を試みて検証
+CPath|`pathlib.Path`型への自動変換を試みて検証
+CString|`str`型への返還を試みて検証
+CTimedelta|`datetime.timedelta`型への自動変換を試みて検証
+
+## 継承規則
+自作のバリデータやコンバータを正しく定義するための規則です。
+
+### Validator継承規則
+1. 命名: クラス名は`V{検証したいクラス名}`とします（例: `VString`）。
+2. 継承: `Validator`クラスを継承します。
+3. 定義: `validate`メソッドを定義し、検証が成功した場合は受け取った`value`を返します。
+4. 変換: `validate`内で`value`の型変換を行ってはいけません（変換を行う場合は`Converter`を使用）。
+
+### VContainer継承規則
+1. 命名: クラス名は`V{検証したいクラス名}`とします（例: `VList`）。
+2. 継承: `VContainer`クラスを継承します。
+3. 定義: `validate`メソッドを定義し、検証通過時は`value`を返します。中身の各要素への検証規則を設定します。
+4. 変換: コンテナ自体の型変換は行いません。ただし要素に対してはオプション設定に応じます。
+
+### Converter継承規則
+1. 命名: `C{変換検証したいクラス名}`とします（例: `CInt`）。
+2. 継承: `（対象クラスのバリデータ, Converter）`の順で多重継承します。
+3. 定義: `validate`内で型変換を行い、`return super().validate(value)`で検証して返します。

otsuvalidator-1.1.0.312/otsuvalidator/__init__.py

@@ -0,0 +1,31 @@
+__version__ = "1.1.0.312"
+from .bases import VChain
+from .converters import (
+    CBool,
+    CFloat,
+    CInt,
+    CNumber,
+    CNumerical,
+    CPath,
+    CString,
+    CTimedelta,
+)
+from .validators import (
+    VAny,
+    VBool,
+    VChoice,
+    VDict,
+    VFloat,
+    VInt,
+    VList,
+    VNone,
+    VNumber,
+    VPath,
+    VRange,
+    VRegex,
+    VSequence,
+    VString,
+    VTimedelta,
+    VTuple,
+    VType,
+)

otsuvalidator-1.1.0.312/otsuvalidator/bases.py

@@ -0,0 +1,137 @@
+__all__ = (
+    "Converter",
+    "Validator",
+    "VChain",
+    "VContainer",
+)
+from abc import ABC, abstractmethod
+from typing import Any, Literal, Self, overload
+
+
+class Validator[OutT](ABC):
+    def __init__(self) -> None:
+        self.public_name: str = ""
+        self.private_name: str = ""
+
+    def __set_name__(self, owner: type[Any], name: str) -> None:
+        """クラス定義時に自動的に呼び出される。
+
+        例: `age = Validator()`と書くと`name`に"age"が入る。
+        """
+        self.public_name = name
+        self.private_name = f"_{name}"
+
+    @overload
+    def __get__(self, instance: None, owner: type[Any]) -> Self: ...
+
+    @overload
+    def __get__(self, instance: Any, owner: type[Any]) -> OutT: ...
+    def __get__(self, instance: Any | None, owner: type[Any]) -> OutT | Self:
+        # クラス属性としてアクセスされた場合
+        # 例: MyClass.age
+        if instance is None:
+            return self
+        # インスタンス属性としてアクセスされた場合
+        # myc_instance.age
+        return getattr(instance, self.private_name)
+
+    def set_name(self, name: str) -> None:
+        """バリデータの表示名を動的に設定する。"""
+        self.public_name = name
+        self.private_name = f"_{name}"
+
+    @abstractmethod
+    def validate(self, value: Any) -> OutT:
+        """
+        [抽象メソッド] 子クラスで必ず実装する必要がある。
+        値が正しければその値を返し、不正なら例外を投げる。
+        """
+        raise NotImplementedError()
+
+    def __set__(self, instance: Any, value: Any) -> None:
+        """値を代入する際に呼び出される。
+
+        `validate`メソッドでチェックを通った値のみ保持する。
+        """
+        # 1. 値を検証(子クラスの実装を呼び出す。)
+        validated_value = self.validate(value)
+        # 2. private_nameでインスタンスに保存
+        setattr(instance, self.private_name, validated_value)
+
+    def __or__[NextOutT](self, other: "Validator[NextOutT]") -> "VChain[NextOutT]":
+        """パイプ演算子によるバリデータの直列連結をサポートする。"""
+        return VChain(self, other)
+
+
+class Converter[InT, OutT](Validator[OutT]):
+    """値を特定の型や形式に変換するディスクリプタの基底クラス。"""
+
+    @abstractmethod
+    def validate(self, value: InT) -> OutT:
+        """入力値を変換して返すロジックを実装する。"""
+        raise NotImplementedError()
+
+    def super_validate(self, value: Any) -> OutT:
+        """変換を行わず、スーパークラスの検証のみを行う。"""
+        return super().validate(value)  # type: ignore
+
+
+class VChain[OutT](Validator[OutT]):
+    """複数のバリデータを直列に実行するクラス。"""
+
+    def __init__(self, *validators: Validator[Any], pass_type: Literal["all", "any"] = "any") -> None:
+        super().__init__()
+        self.validators: tuple[Validator[Any], ...] = validators
+        self.pass_type: Literal["all", "any"] = pass_type
+
+    def validate(self, value: Any) -> OutT:
+        current_value = value
+        validators = self.validators
+        if self.pass_type == "all":
+            for validator in validators:
+                current_value = validator.validate(current_value)
+        else:
+            passed = False
+            exceptions = []
+            for validator in validators:
+                try:
+                    tmp = validator.validate(current_value)
+                    current_value = tmp
+                    passed = True
+                except Exception as ex:
+                    exceptions.append(ex)
+            if not passed:
+                raise ValueError(*exceptions)
+        return current_value
+
+    def __or__[NextOutT](self, other: Validator[NextOutT]) -> "VChain[NextOutT]":
+        return VChain(*self.validators, other)
+
+
+class VContainer[OutT](Validator[OutT]):
+    """
+    VDict, VList, VTuple などの構造を持つバリデータの基底クラス。
+    スキーマの保持や、動的な再検証フラグの管理を行う。
+    """
+
+    def __init__(
+        self,
+        schema: Any,
+        *,
+        monitoring_overwrite: bool = False,
+    ) -> None:
+        super().__init__()
+        self.schema = schema
+        self.monitoring_overwrite = monitoring_overwrite
+
+    def __get__(self, instance: Any | None, owner: type[Any]) -> OutT | Self:  # type: ignore
+        """
+        monitoring_overwrite が True の場合、
+        値を取得する際にも再検証を実行するようにオーバーライド。
+        """
+        if instance is None:
+            return self
+        value = getattr(instance, self.private_name)
+        if self.monitoring_overwrite:
+            return self.validate(value)
+        return value

otsuvalidator-1.1.0.312/otsuvalidator/converters.py

@@ -0,0 +1,282 @@
+__all__ = (
+    "CBool",
+    "CFloat",
+    "CInt",
+    "CNumber",
+    "CNumerical",
+    "CPath",
+    "CString",
+    "CTimedelta",
+)
+
+
+import re
+import warnings
+from collections.abc import Callable
+from datetime import timedelta
+from pathlib import Path
+from typing import Any, Literal, override
+
+from .bases import Converter
+from .types import FLOAT_INT, StrPath
+from .validators import VBool, VFloat, VInt, VNumber, VPath, VString, VTimedelta
+
+
+class CBool(VBool, Converter[Any, bool]):
+    """VBoolの拡張バリデータ。
+
+    一般にYes/Noとして解釈できる値に対し、bool変換を試みます。
+    bool(value)とは異なる結果を返すことがあります。
+    また、Trueにしたい値、Falseにしたい値をタプル形式で登録することでその通りに判定するようになります。
+
+    str型, float型, int型に対応しています。
+    また、str型はすべてstr.lowerされた後に判定されます。
+
+    Trueに変換される値
+        str型: 'true', 'yes', 'y', '1'
+        int型: 1
+        float型: 1.0
+
+    Falseに変換される値
+        str型: 'false', 'no', 'n', '0'
+        int型: 0
+        float型: 0.0
+    """
+
+    def __init__(
+        self,
+        true_data: tuple[Any, ...] | None = None,
+        false_data: tuple[Any, ...] | None = None,
+        checker: tuple[Callable[[Any], bool], ...] | None = None,
+    ) -> None:
+        """ユーザ定義のTrueにしたい値、Falseにしたい値を設定してバリデータを生成します。
+
+        Args:
+            true_data (Optional[Tuple[Any, ...]], optional): Trueにしたい値です。
+            false_data (Optional[Tuple[Any, ...]], optional): Falseにしたい値です。
+            checker (Optional[Tuple[Callable[[Any], bool], ...]], optional): 真偽判定用の関数です。
+        """
+        self.true_data = true_data
+        self.false_data = false_data
+        self.checker = checker
+
+    def validate(self, value: Any) -> bool:
+        # ユーザ定義で真偽確認
+        tmp_value = value
+        if (checker := self.true_data) is not None and value in checker:
+            return super().validate(True)
+        if (checker := self.false_data) is not None and value in checker:
+            return super().validate(False)
+        if (checker := self.checker) is not None:
+            for c in checker:
+                try:
+                    tmp = c(tmp_value)
+                    if tmp is None:
+                        continue
+                    tmp_value = tmp  # type: ignore
+                except Exception:
+                    continue
+        # クラス定義で真偽を確認
+        if (tv := type(tmp_value)) is bool:
+            pass
+        elif tv is str:
+            tmp_value: str
+            tmp_value = tmp_value.lower()
+            if tmp_value in (yes := ("true", "yes", "y", "1")):
+                tmp_value = True  # type: ignore
+            elif tmp_value in (no := ("false", "no", "n", "0")):
+                tmp_value = False  # type: ignore
+            else:
+                msg = f"{yes}または{no}のいずれかである必要があります。\n{tmp_value=}"
+                raise ValueError(msg)
+        elif tv is int:
+            if tmp_value == 1:
+                tmp_value = True  # type: ignore
+            elif tmp_value == 0:
+                tmp_value = False  # type: ignore
+            else:
+                msg = f"1または0である必要があります。\n{tmp_value=}"
+                raise ValueError(msg)
+        elif tv is float:
+            if tmp_value == 1.0:
+                tmp_value = True  # type: ignore
+            elif tmp_value == 0.0:
+                tmp_value = False  # type: ignore
+            else:
+                msg = f"1.0または0.0である必要があります。\n{tmp_value=}"
+                raise ValueError(msg)
+        else:
+            msg = f"Yes/Noとして解釈できる必要があります。\n{tmp_value=}"
+            raise TypeError(msg)
+        return super().validate(tmp_value)
+
+
+class CNumerical[OutT: FLOAT_INT](VNumber[OutT], Converter[Any, OutT]):
+    """
+    数値を変換し、範囲を検証するコンバータの基底クラス。
+    """
+
+    def __init__(
+        self,
+        target_type: type[OutT] | None = None,
+        min_val: OutT | None = None,
+        max_val: OutT | None = None,
+        *,
+        type_strict: bool = False,
+    ) -> None:
+        super().__init__(min_val, max_val, type_strict=type_strict)
+        self.target_type = target_type
+
+    @override
+    def validate(self, value: Any) -> OutT:
+        """入力値を target_type に変換してから、VNumber の検証を実行する。"""
+        # 1. 変換試行
+        t_type = self.target_type
+        try:
+            if isinstance(value, bool):
+                raise ValueError
+            if t_type is None:
+                # 動的判定モード
+                f_val = float(value)
+                if f_val.is_integer():
+                    converted = int(f_val)
+                else:
+                    converted = f_val
+            else:
+                converted = t_type(value)
+        except (TypeError, ValueError):
+            type_name = t_type.__name__ if t_type else "number"
+            msg = f"'{self.public_name}'を{type_name}に変換できませんでした: {value!r}。"
+            raise ValueError(msg) from None
+        return super().validate(converted)
+
+
+class CNumber[OutT: FLOAT_INT](CNumerical[OutT]):
+    """
+    [非推奨]CNumberは非推奨です。将来のバージョンで削除されます。
+    代わりにCNumericalを使用してください。
+    """
+
+    def __init__(
+        self,
+        target_type: type[OutT],
+        min_val: OutT | None = None,
+        max_val: OutT | None = None,
+        *,
+        type_strict: bool = False,
+    ) -> None:
+        msg = "CNumberは非推奨です。代わりにCNumericalを使用してください。"
+        warnings.warn(msg, DeprecationWarning, stacklevel=2)
+        super().__init__(target_type, min_val, max_val, type_strict=type_strict)
+
+
+class CInt(CNumerical[int]):
+    """
+    値を整数に変換し、範囲を検証するコンバータ。
+    """
+
+    def __init__(
+        self,
+        min_val: int | None = None,
+        max_val: int | None = None,
+    ) -> None:
+        super().__init__(target_type=int, min_val=min_val, max_val=max_val)
+
+
+class CFloat(CNumerical[float]):
+    """
+    値を浮動小数点数に変換し、範囲を検証するコンバータ。
+    """
+
+    def __init__(
+        self,
+        min_val: float | None = None,
+        max_val: float | None = None,
+    ) -> None:
+        super().__init__(target_type=float, min_val=min_val, max_val=max_val)
+
+
+class CPath(VPath, Converter[StrPath, Path]):
+    """文字列をPathオブジェクトに変換し、属性を検証するコンバータ。"""
+
+    def __init__(
+        self,
+        *extensions: str,
+        must_exist: bool = False,
+        path_type: Callable[[Path], bool] | None | Literal["dir", "file"] = None,
+    ) -> None:
+        super().__init__(*extensions, must_exist=must_exist, path_type=path_type)
+
+    @override
+    def validate(self, value: Any) -> Path:
+        """Pathオブジェクトに変換してから、VPathの検証を実行する。"""
+        try:
+            converted = Path(value)
+        except (TypeError, ValueError):
+            msg = f"'{self.public_name}'をpathlib.Pathオブジェクトに変換できませんでした: {value!r}。"
+            raise TypeError(msg) from None
+        return super().validate(converted)
+
+
+class CString(VString, Converter[Any, str]):
+    """VStringの拡張バリデータ。
+
+    str型に変換可能なオブジェクトは例外を投げずに変換を行います。
+    """
+
+    def validate(self, value: Any) -> str:
+        tmp_value = value
+        if type(tmp_value) is not str:
+            try:
+                tmp_value = str(tmp_value)
+            except Exception:
+                msg = f"'{self.public_name}'はstr型に変換可能な値である必要があります: {tmp_value!r}。"
+                raise TypeError(msg) from None
+        return super().validate(tmp_value)
+
+
+class CTimedelta(VTimedelta, Converter[Any, timedelta]):
+    """VTimedeltaの拡張バリデータです。
+
+    timedelta型に変換可能なオブジェクトは例外を投げずに変換を行います。
+    """
+
+    cmp_timedelta = re.compile(r"(?:(\d+) days?,? )?(\d+):(\d+):(\d+)(?:\.(\d+))?")
+
+    def validate(self, value: Any) -> timedelta:
+        f = None
+        if (tv := type(value)) is dict:
+            f = self.__try_convert_dict
+        elif tv in (list, tuple):
+            f = self.__try_convert_container
+        elif tv is str:
+            f = self.__try_convert_str
+        tmp_value = value
+        try:
+            if f is not None:
+                tmp_value = f(tmp_value)
+        except Exception:
+            msg = f"'{self.public_name}'はtimedelta型に変換可能な値である必要があります: {tmp_value!r}。"
+            raise TypeError(msg) from None
+        return super().validate(tmp_value)
+
+    def __try_convert_container(self, value: list | tuple) -> timedelta:
+        return timedelta(*value)
+
+    def __try_convert_dict(self, value: dict) -> timedelta:
+        return timedelta(**value)
+
+    def __try_convert_str(self, value: str) -> timedelta:
+        if (match := self.cmp_timedelta.fullmatch(value)) is not None:
+            keys = ("days", "hours", "minutes", "seconds", "microseconds")
+            d = {}
+            for k, v in zip(keys, match.groups(), strict=True):
+                if v is None:
+                    continue
+                if k == "microseconds":
+                    v = v.ljust(6, "0")[:6]
+                v = int(v)
+                d[k] = v
+            return self.__try_convert_dict(d)
+        msg = f"'{value}'をtimedelta型に変換できませんでした。"
+        raise ValueError(msg)