コンテンツにスキップ

Validate Call

関数呼び出しを検証するためのデコレータ

validate_call

validate_call(
    func: AnyCallableT | None = None,
    /,
    *,
    config: ConfigDict | None = None,
    validate_return: bool = False,
) -> AnyCallableT | Callable[[AnyCallableT], AnyCallableT]

Usage Documentation

Validation Decorator

引数およびオプションで戻り値を検証する関数を囲むデコレートラッパーを返します。

通常のデコレータ@validate_callとして、または引数@validate_call(...)と共に使用できます。

Parameters:

Name Type Description Default
func AnyCallableT | None

デコレートする関数。

None
config ConfigDict | None

構成辞書。

None
validate_return bool

戻り値を検証するかどうか。

False

Returns:

Type Description
AnyCallableT | Callable[[AnyCallableT], AnyCallableT]

The decorated function.

Source code in pydantic/validate_call_decorator.py
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
def validate_call(
    func: AnyCallableT | None = None,
    /,
    *,
    config: ConfigDict | None = None,
    validate_return: bool = False,
) -> AnyCallableT | Callable[[AnyCallableT], AnyCallableT]:
    """Usage docs: https://yodai-yodai.github.io/translated/pydantic-docs-ja/concepts/validation_decorator/

    引数およびオプションで戻り値を検証する関数を囲むデコレートラッパーを返します。

    通常のデコレータ`@validate_call`として、または引数`@validate_call(...)`と共に使用できます。

    Args:
        func: デコレートする関数。
        config: 構成辞書。
        validate_return: 戻り値を検証するかどうか。

    Returns:
        The decorated function.
    """
    local_ns = _typing_extra.parent_frame_namespace()

    def validate(function: AnyCallableT) -> AnyCallableT:
        if isinstance(function, (classmethod, staticmethod)):
            name = type(function).__name__
            raise TypeError(f'The `@{name}` decorator should be applied after `@validate_call` (put `@{name}` on top)')

        validate_call_wrapper = _validate_call.ValidateCallWrapper(function, config, validate_return, local_ns)

        @functools.wraps(function)
        def wrapper_function(*args, **kwargs):
            return validate_call_wrapper(*args, **kwargs)

        wrapper_function.raw_function = function  # type: ignore

        return wrapper_function  # type: ignore

    if func:
        return validate(func)
    else:
        return validate