PHP 8.2.30
Preview: repr.py Size: 4.34 KB
/proc/self/root/opt/alt/python38/lib/python3.8/site-packages/pip/_vendor/rich/repr.py

from functools import partial
import inspect
import sys

from typing import (
    Any,
    Callable,
    Iterable,
    List,
    Optional,
    overload,
    Union,
    Tuple,
    Type,
    TypeVar,
)


T = TypeVar("T")


Result = Iterable[Union[Any, Tuple[Any], Tuple[str, Any], Tuple[str, Any, Any]]]
RichReprResult = Result


class ReprError(Exception):
    """An error occurred when attempting to build a repr."""


@overload
def auto(cls: Optional[Type[T]]) -> Type[T]:
    ...


@overload
def auto(*, angular: bool = False) -> Callable[[Type[T]], Type[T]]:
    ...


def auto(
    cls: Optional[Type[T]] = None, *, angular: Optional[bool] = None
) -> Union[Type[T], Callable[[Type[T]], Type[T]]]:
    """Class decorator to create __repr__ from __rich_repr__"""

    def do_replace(cls: Type[T], angular: Optional[bool] = None) -> Type[T]:
        def auto_repr(self: T) -> str:
            """Create repr string from __rich_repr__"""
            repr_str: List[str] = []
            append = repr_str.append

            angular: bool = getattr(self.__rich_repr__, "angular", False)  # type: ignore[attr-defined]
            for arg in self.__rich_repr__():  # type: ignore[attr-defined]
                if isinstance(arg, tuple):
                    if len(arg) == 1:
                        append(repr(arg[0]))
                    else:
                        key, value, *default = arg
                        if key is None:
                            append(repr(value))
                        else:
                            if len(default) and default[0] == value:
                                continue
                            append(f"{key}={value!r}")
                else:
                    append(repr(arg))
            if angular:
                return f"<{self.__class__.__name__} {' '.join(repr_str)}>"
            else:
                return f"{self.__class__.__name__}({', '.join(repr_str)})"

        def auto_rich_repr(self: Type[T]) -> Result:
            """Auto generate __rich_rep__ from signature of __init__"""
            try:
                signature = inspect.signature(self.__init__)
                for name, param in signature.parameters.items():
                    if param.kind == param.POSITIONAL_ONLY:
                        yield getattr(self, name)
                    elif param.kind in (
                        param.POSITIONAL_OR_KEYWORD,
                        param.KEYWORD_ONLY,
                    ):
                        if param.default == param.empty:
                            yield getattr(self, param.name)
                        else:
                            yield param.name, getattr(self, param.name), param.default
            except Exception as error:
                raise ReprError(
                    f"Failed to auto generate __rich_repr__; {error}"
                ) from None

        if not hasattr(cls, "__rich_repr__"):
            auto_rich_repr.__doc__ = "Build a rich repr"
            cls.__rich_repr__ = auto_rich_repr  # type: ignore[attr-defined]

        auto_repr.__doc__ = "Return repr(self)"
        cls.__repr__ = auto_repr  # type: ignore[assignment]
        if angular is not None:
            cls.__rich_repr__.angular = angular  # type: ignore[attr-defined]
        return cls

    if cls is None:
        return partial(do_replace, angular=angular)
    else:
        return do_replace(cls, angular=angular)


@overload
def rich_repr(cls: Optional[Type[T]]) -> Type[T]:
    ...


@overload
def rich_repr(*, angular: bool = False) -> Callable[[Type[T]], Type[T]]:
    ...


def rich_repr(
    cls: Optional[Type[T]] = None, *, angular: bool = False
) -> Union[Type[T], Callable[[Type[T]], Type[T]]]:
    if cls is None:
        return auto(angular=angular)
    else:
        return auto(cls)


if __name__ == "__main__":

    @auto
    class Foo:
        def __rich_repr__(self) -> Result:
            yield "foo"
            yield "bar", {"shopping": ["eggs", "ham", "pineapple"]}
            yield "buy", "hand sanitizer"

    foo = Foo()
    from pip._vendor.rich.console import Console

    console = Console()

    console.rule("Standard repr")
    console.print(foo)

    console.print(foo, width=60)
    console.print(foo, width=30)

    console.rule("Angular repr")
    Foo.__rich_repr__.angular = True  # type: ignore[attr-defined]

    console.print(foo)

    console.print(foo, width=60)
    console.print(foo, width=30)

Directory Contents

Dirs: 1 × Files: 75

Name Size Perms Modified Actions
- drwxr-xr-x 2024-03-03 22:49:50
Edit Download
890 B lrw-r--r-- 2023-11-13 21:40:26
Edit Download
10.13 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
6.66 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
3.19 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
9.63 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
4.40 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
17.54 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
1.03 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
6.96 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
93.64 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
1.26 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
5.37 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
6.47 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
7.77 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
972 B lrw-r--r-- 2023-11-13 21:40:26
Edit Download
2.44 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
642 B lrw-r--r-- 2023-11-13 21:40:26
Edit Download
2.45 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
1.58 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
9.36 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
4.93 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
3.18 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
13.74 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
13.84 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
3.58 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
11.20 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
8.01 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
5.18 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
4.85 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
828 B lrw-r--r-- 2023-11-13 21:40:26
Edit Download
3.32 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
8.54 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
35.72 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
58.35 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
7.97 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
11.04 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
1.36 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
166 B lrw-r--r-- 2023-11-13 21:40:26
Edit Download
4.34 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
4.66 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
2.78 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
1.55 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
23.66 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
4.27 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
4.32 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
25.63 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
1.23 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
33.88 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
38.59 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
3.29 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
43.62 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
3.54 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
102 B lrw-r--r-- 2023-11-13 21:40:26
Edit Download
25.45 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
8.95 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
9.86 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
136.95 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
1.04 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
2.06 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
265 B lrw-r--r-- 2023-11-13 21:40:26
Edit Download
9.47 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
3.15 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
1.21 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
6.90 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
423 B lrw-r--r-- 2023-11-13 21:40:26
Edit Download
5.34 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
19.45 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
351 B lrw-r--r-- 2023-11-13 21:40:26
Edit Download
417 B lrw-r--r-- 2023-11-13 21:40:26
Edit Download
22.29 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
1.88 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
2.72 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
1.80 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
5.80 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download
8.60 KB lrw-r--r-- 2023-11-13 21:40:26
Edit Download

If ZipArchive is unavailable, a .tar will be created (no compression).