aboutsummaryrefslogtreecommitdiffstats
path: root/python-packages/order_utils/src/zero_ex/dev_utils/type_assertions.py
blob: 745d014e6ac285dc53bff1b89dfacdeacd3f4fed (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
"""Assertions for runtime type checking of function arguments."""

from typing import Any


def assert_is_string(value: Any, name: str) -> None:
    """If :param value: isn't of type str, raise a TypeError.

    >>> try: assert_is_string(123, 'var')
    ... except TypeError as type_error: print(str(type_error))
    ...
    expected variable 'var', with value 123, to have type 'str', not 'int'
    """
    if not isinstance(value, str):
        raise TypeError(
            f"expected variable '{name}', with value {str(value)}, to have"
            + f" type 'str', not '{type(value).__name__}'"
        )


def assert_is_list(value: Any, name: str) -> None:
    """If :param value: isn't of type list, raise a TypeError.

    >>> try: assert_is_list(123, 'var')
    ... except TypeError as type_error: print(str(type_error))
    ...
    expected variable 'var', with value 123, to have type 'list', not 'int'
    """
    if not isinstance(value, list):
        raise TypeError(
            f"expected variable '{name}', with value {str(value)}, to have"
            + f" type 'list', not '{type(value).__name__}'"
        )