Beta Shell v2.0

File Manager

~ /usr/local/python-3.12/lib/python3.12/site-packages/bs4

Name	Size	Perms	Modified	Actions
[ .. / .. ]
__init__.py	43.35 KB	-rw-r--r--	2025-10-22 11:03:13	Edit Del
__pycache__	-	drwxr-xr-x	2025-10-22 11:03:13	Del
_deprecation.py	2.35 KB	-rw-r--r--	2025-10-22 11:03:13	Edit Del
_typing.py	7.37 KB	-rw-r--r--	2025-10-22 11:03:13	Edit Del
_warnings.py	4.6 KB	-rw-r--r--	2025-10-22 11:03:13	Edit Del
builder	-	drwxr-xr-x	2025-10-22 11:03:13	Del
css.py	12.42 KB	-rw-r--r--	2025-10-22 11:03:13	Edit Del
dammit.py	50.29 KB	-rw-r--r--	2025-10-22 11:03:13	Edit Del
diagnose.py	7.66 KB	-rw-r--r--	2025-10-22 11:03:13	Edit Del
element.py	117.42 KB	-rw-r--r--	2025-10-22 11:03:13	Edit Del
exceptions.py	951 B	-rw-r--r--	2025-10-22 11:03:13	Edit Del
filter.py	28.52 KB	-rw-r--r--	2025-10-22 11:03:13	Edit Del
formatter.py	10.23 KB	-rw-r--r--	2025-10-22 11:03:13	Edit Del
py.typed	0 B	-rw-r--r--	2025-10-22 11:03:13	Edit Del

Editing: _deprecation.py (2.35 KB)

"""Helper functions for deprecation.

This interface is itself unstable and may change without warning. Do
not use these functions yourself, even as a joke. The underscores are
there for a reason. No support will be given.

In particular, most of this will go away without warning once
Beautiful Soup drops support for Python 3.11, since Python 3.12
defines a `@typing.deprecated()
decorator. <https://peps.python.org/pep-0702/>`_
"""

import functools
import warnings

from typing import (
    Any,
    Callable,
)


def _deprecated_alias(old_name: str, new_name: str, version: str):
    """Alias one attribute name to another for backward compatibility

    :meta private:
    """

    @property # type:ignore
    def alias(self) -> Any:
        ":meta private:"
        warnings.warn(
            f"Access to deprecated property {old_name}. (Replaced by {new_name}) -- Deprecated since version {version}.",
            DeprecationWarning,
            stacklevel=2,
        )
        return getattr(self, new_name)

    @alias.setter
    def alias(self, value: str) -> None:
        ":meta private:"
        warnings.warn(
            f"Write to deprecated property {old_name}. (Replaced by {new_name}) -- Deprecated since version {version}.",
            DeprecationWarning,
            stacklevel=2,
        )
        return setattr(self, new_name, value)

    return alias


def _deprecated_function_alias(
    old_name: str, new_name: str, version: str
) -> Callable[[Any], Any]:
    def alias(self, *args: Any, **kwargs: Any) -> Any:
        ":meta private:"
        warnings.warn(
            f"Call to deprecated method {old_name}. (Replaced by {new_name}) -- Deprecated since version {version}.",
            DeprecationWarning,
            stacklevel=2,
        )
        return getattr(self, new_name)(*args, **kwargs)

    return alias


def _deprecated(replaced_by: str, version: str) -> Callable:
    def deprecate(func: Callable) -> Callable:
        @functools.wraps(func)
        def with_warning(*args: Any, **kwargs: Any) -> Any:
            ":meta private:"
            warnings.warn(
                f"Call to deprecated method {func.__name__}. (Replaced by {replaced_by}) -- Deprecated since version {version}.",
                DeprecationWarning,
                stacklevel=2,
            )
            return func(*args, **kwargs)

        return with_warning

    return deprecate