-Ph dZddlmZddlZddlZGddeZGddeZeZ dej vrej d e  dd d ddZ dS)z)Sphinx deprecation classes and utilities.) annotationsNceZdZdS)RemovedInSphinx90WarningN__name__ __module__ __qualname__R/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/sphinx/deprecation.pyrr Dr rceZdZdS)RemovedInSphinx10WarningNrr r r rr r r rPYTHONWARNINGSdefault)categoryF)raisesmodulestr attributecanonical_nameremovetuple[int, int]rboolreturnNonec|dkrt}n#|dkrt}nd|d}t||d|}|r d|d|d}n|d }|rt||d }t j||d d S)aXHelper function for module-level deprecations using ``__getattr__``. :param module: The module containing a deprecated object. :param attribute: The name of the deprecated object. :param canonical_name: Optional fully-qualified name for its replacement. :param remove: Target version for removal. :param raises: Indicate whether to raise an exception instead of a warning. When *raises* is ``True``, an :exc:`AttributeError` is raised instead of emitting a warning so that it is easy to locate deprecated objects in tests that could suppress deprecation warnings. Usage:: # deprecated name -> (object to return, canonical path or empty string, removal version) _DEPRECATED_OBJECTS = { 'deprecated_name': ( object_to_return, 'fully_qualified_replacement_name', (9, 0), ), } def __getattr__(name: str) -> Any: if name not in _DEPRECATED_OBJECTS: msg = f'module {__name__!r} has no attribute {name!r}' raise AttributeError(msg) from sphinx.deprecation import _deprecation_warning deprecated_object, canonical_name, remove = _DEPRECATED_OBJECTS[name] _deprecation_warning(__name__, name, canonical_name, remove=remove) return deprecated_object ) r) rzremoval version z is invalid!.z The alias z is deprecated, use z instead.z is deprecated.z, Check CHANGES for Sphinx API modifications.) stacklevelN)rr RuntimeErrorAttributeErrorwarningswarn) rrrrr warning_classmsgqualnamemessages r _deprecation_warningr,sV'? 7  0 77773&&9&&H1 T T T T T T 000 &W%%%FFFG M'=Q777777r )r) rrrrrrrrrrrr) __doc__ __future__rosr&DeprecationWarningrPendingDeprecationWarningrRemovedInNextVersionWarningenvironfilterwarningsr,r r r r5s//""""""      1        8   7 2:%%HI0KLLLL ?8  ?8?8?8?8?8?8?8?8r