Skip to content

deprecation

DeprecationModuleWrapper

Bases: ModuleType

Module wrapper that issues a deprecation warning when importing.

Source code in griptape/utils/deprecation.py 
 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
class DeprecationModuleWrapper(ModuleType):
    """Module wrapper that issues a deprecation warning when importing."""

    __ignore_attrs__ = {
        "__file__",
        "__package__",
        "__path__",
        "__doc__",
        "__all__",
        "__name__",
        "__loader__",
        "__spec__",
    }

    def __init__(self, real_module: Any, deprecation_message: str) -> None:
        self._real_module = real_module
        self._deprecation_message = deprecation_message

    def __getattr__(self, name: str) -> Any:
        if name not in self.__ignore_attrs__:
            warnings.warn(
                self._deprecation_message,
                DeprecationWarning,
                stacklevel=2,
            )
        return getattr(self._real_module, name)

__ignore_attrs__ = {'__file__', '__package__', '__path__', '__doc__', '__all__', '__name__', '__loader__', '__spec__'} class-attribute instance-attribute

_deprecation_message = deprecation_message instance-attribute

_real_module = real_module instance-attribute

__getattr__(name)

Source code in griptape/utils/deprecation.py 
24
25
26
27
28
29
30
31
def __getattr__(self, name: str) -> Any:
    if name not in self.__ignore_attrs__:
        warnings.warn(
            self._deprecation_message,
            DeprecationWarning,
            stacklevel=2,
        )
    return getattr(self._real_module, name)

__init__(real_module, deprecation_message)

Source code in griptape/utils/deprecation.py 
20
21
22
def __init__(self, real_module: Any, deprecation_message: str) -> None:
    self._real_module = real_module
    self._deprecation_message = deprecation_message

deprecation_warn(message, stacklevel=2)

Source code in griptape/utils/deprecation.py 
34
35
36
37
def deprecation_warn(message: str, stacklevel: int = 2) -> None:
    warnings.simplefilter("always", DeprecationWarning)
    warnings.warn(message, category=DeprecationWarning, stacklevel=stacklevel)
    warnings.simplefilter("default", DeprecationWarning)