PHP 8.2.30
Preview: measure.py Size: 5.18 KB
/proc/thread-self/root/proc/self/root/opt/hc_python/lib/python3.12/site-packages/pip/_vendor/rich/measure.py

from operator import itemgetter
from typing import TYPE_CHECKING, Callable, NamedTuple, Optional, Sequence

from . import errors
from .protocol import is_renderable, rich_cast

if TYPE_CHECKING:
    from .console import Console, ConsoleOptions, RenderableType


class Measurement(NamedTuple):
    """Stores the minimum and maximum widths (in characters) required to render an object."""

    minimum: int
    """Minimum number of cells required to render."""
    maximum: int
    """Maximum number of cells required to render."""

    @property
    def span(self) -> int:
        """Get difference between maximum and minimum."""
        return self.maximum - self.minimum

    def normalize(self) -> "Measurement":
        """Get measurement that ensures that minimum <= maximum and minimum >= 0

        Returns:
            Measurement: A normalized measurement.
        """
        minimum, maximum = self
        minimum = min(max(0, minimum), maximum)
        return Measurement(max(0, minimum), max(0, max(minimum, maximum)))

    def with_maximum(self, width: int) -> "Measurement":
        """Get a RenderableWith where the widths are <= width.

        Args:
            width (int): Maximum desired width.

        Returns:
            Measurement: New Measurement object.
        """
        minimum, maximum = self
        return Measurement(min(minimum, width), min(maximum, width))

    def with_minimum(self, width: int) -> "Measurement":
        """Get a RenderableWith where the widths are >= width.

        Args:
            width (int): Minimum desired width.

        Returns:
            Measurement: New Measurement object.
        """
        minimum, maximum = self
        width = max(0, width)
        return Measurement(max(minimum, width), max(maximum, width))

    def clamp(
        self, min_width: Optional[int] = None, max_width: Optional[int] = None
    ) -> "Measurement":
        """Clamp a measurement within the specified range.

        Args:
            min_width (int): Minimum desired width, or ``None`` for no minimum. Defaults to None.
            max_width (int): Maximum desired width, or ``None`` for no maximum. Defaults to None.

        Returns:
            Measurement: New Measurement object.
        """
        measurement = self
        if min_width is not None:
            measurement = measurement.with_minimum(min_width)
        if max_width is not None:
            measurement = measurement.with_maximum(max_width)
        return measurement

    @classmethod
    def get(
        cls, console: "Console", options: "ConsoleOptions", renderable: "RenderableType"
    ) -> "Measurement":
        """Get a measurement for a renderable.

        Args:
            console (~rich.console.Console): Console instance.
            options (~rich.console.ConsoleOptions): Console options.
            renderable (RenderableType): An object that may be rendered with Rich.

        Raises:
            errors.NotRenderableError: If the object is not renderable.

        Returns:
            Measurement: Measurement object containing range of character widths required to render the object.
        """
        _max_width = options.max_width
        if _max_width < 1:
            return Measurement(0, 0)
        if isinstance(renderable, str):
            renderable = console.render_str(
                renderable, markup=options.markup, highlight=False
            )
        renderable = rich_cast(renderable)
        if is_renderable(renderable):
            get_console_width: Optional[
                Callable[["Console", "ConsoleOptions"], "Measurement"]
            ] = getattr(renderable, "__rich_measure__", None)
            if get_console_width is not None:
                render_width = (
                    get_console_width(console, options)
                    .normalize()
                    .with_maximum(_max_width)
                )
                if render_width.maximum < 1:
                    return Measurement(0, 0)
                return render_width.normalize()
            else:
                return Measurement(0, _max_width)
        else:
            raise errors.NotRenderableError(
                f"Unable to get render width for {renderable!r}; "
                "a str, Segment, or object with __rich_console__ method is required"
            )


def measure_renderables(
    console: "Console",
    options: "ConsoleOptions",
    renderables: Sequence["RenderableType"],
) -> "Measurement":
    """Get a measurement that would fit a number of renderables.

    Args:
        console (~rich.console.Console): Console instance.
        options (~rich.console.ConsoleOptions): Console options.
        renderables (Iterable[RenderableType]): One or more renderable objects.

    Returns:
        Measurement: Measurement object containing range of character widths required to
            contain all given renderables.
    """
    if not renderables:
        return Measurement(0, 0)
    get_measurement = Measurement.get
    measurements = [
        get_measurement(console, options, renderable) for renderable in renderables
    ]
    measured_width = Measurement(
        max(measurements, key=itemgetter(0)).minimum,
        max(measurements, key=itemgetter(1)).maximum,
    )
    return measured_width

Directory Contents

Dirs: 1 × Files: 79

Name Size Perms Modified Actions
- drwxr-xr-x 2025-12-03 08:02:42
Edit Download
890 B lrw-r--r-- 2025-12-03 08:02:41
Edit Download
10.08 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
6.76 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
3.19 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
10.44 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
5.01 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
17.78 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
1.03 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
6.96 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
98.49 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
1.26 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
5.37 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
6.33 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
8.06 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
1.00 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
2.31 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
642 B lrw-r--r-- 2025-12-03 08:02:41
Edit Download
2.43 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
1.64 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
9.36 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
4.91 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
3.18 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
13.68 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
1.03 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
14.82 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
3.44 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
12.18 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
8.25 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
5.18 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
4.79 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
828 B lrw-r--r-- 2025-12-03 08:02:41
Edit Download
3.32 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
10.90 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
35.54 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
58.99 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
7.97 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
12.16 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
1.36 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
0 B lrw-r--r-- 2025-12-03 08:02:41
Edit Download
166 B lrw-r--r-- 2025-12-03 08:02:41
Edit Download
4.33 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
4.49 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
2.78 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
1.55 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
24.16 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
4.12 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
4.32 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
26.36 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
1.23 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
35.52 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
39.11 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
3.29 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
46.44 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
3.68 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
102 B lrw-r--r-- 2025-12-03 08:02:41
Edit Download
35.02 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
9.23 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
9.97 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
136.95 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
1.04 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
2.08 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
265 B lrw-r--r-- 2025-12-03 08:02:41
Edit Download
799 B lrw-r--r-- 2025-12-03 08:02:41
Edit Download
9.43 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
3.15 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
1.21 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
1.36 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
6.90 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
423 B lrw-r--r-- 2025-12-03 08:02:41
Edit Download
5.20 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
19.45 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
351 B lrw-r--r-- 2025-12-03 08:02:41
Edit Download
417 B lrw-r--r-- 2025-12-03 08:02:41
Edit Download
22.22 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
1.88 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
2.72 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
3.32 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
5.95 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download
7.71 KB lrw-r--r-- 2025-12-03 08:02:41
Edit Download

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