Gecko [ contributie.vriendennsm.nl ]

Name	Size	Permission	Date
__pycache__	[ DIR ]	drwxr-xr-x	2025-01-15 04:26
__init__.py	5.92 KB	-rw-r--r--	2023-02-14 03:31
__main__.py	8.14 KB	-rw-r--r--	2023-02-14 03:31
_cell_widths.py	9.86 KB	-rw-r--r--	2023-02-14 03:31
_emoji_codes.py	136.95 KB	-rw-r--r--	2023-02-14 03:31
_emoji_replace.py	1.04 KB	-rw-r--r--	2023-02-14 03:31
_export_format.py	2.06 KB	-rw-r--r--	2023-02-14 03:31
_extension.py	241 B	-rw-r--r--	2023-02-14 03:31
_fileno.py	799 B	-rw-r--r--	2023-02-14 03:31
_inspect.py	9.47 KB	-rw-r--r--	2023-02-14 03:31
_log_render.py	3.14 KB	-rw-r--r--	2023-02-14 03:31
_loop.py	1.21 KB	-rw-r--r--	2023-02-14 03:31
_null_file.py	1.35 KB	-rw-r--r--	2023-02-14 03:31
_palettes.py	6.9 KB	-rw-r--r--	2023-02-14 03:31
_pick.py	423 B	-rw-r--r--	2023-02-14 03:31
_ratio.py	5.33 KB	-rw-r--r--	2023-02-14 03:31
_spinners.py	19.45 KB	-rw-r--r--	2023-02-14 03:31
_stack.py	351 B	-rw-r--r--	2023-02-14 03:31
_timer.py	417 B	-rw-r--r--	2023-02-14 03:31
_win32_console.py	22.25 KB	-rw-r--r--	2023-02-14 03:31
_windows.py	1.86 KB	-rw-r--r--	2023-02-14 03:31
_windows_renderer.py	2.69 KB	-rw-r--r--	2023-02-14 03:31
_wrap.py	1.8 KB	-rw-r--r--	2023-02-14 03:31
abc.py	878 B	-rw-r--r--	2023-02-14 03:31
align.py	10.08 KB	-rw-r--r--	2023-02-14 03:31
ansi.py	6.66 KB	-rw-r--r--	2023-02-14 03:31
bar.py	3.19 KB	-rw-r--r--	2023-02-14 03:31
box.py	9.56 KB	-rw-r--r--	2023-02-14 03:31
cells.py	4.4 KB	-rw-r--r--	2023-02-14 03:31
color.py	17.8 KB	-rw-r--r--	2023-02-14 03:31
color_triplet.py	1.03 KB	-rw-r--r--	2023-02-14 03:31
columns.py	6.96 KB	-rw-r--r--	2023-02-14 03:31
console.py	96.7 KB	-rw-r--r--	2023-02-14 03:31
constrain.py	1.26 KB	-rw-r--r--	2023-02-14 03:31
containers.py	5.37 KB	-rw-r--r--	2023-02-14 03:31
control.py	6.45 KB	-rw-r--r--	2023-02-14 03:31
default_styles.py	7.86 KB	-rw-r--r--	2023-02-14 03:31
diagnose.py	924 B	-rw-r--r--	2023-02-14 03:31
emoji.py	2.41 KB	-rw-r--r--	2023-02-14 03:31
errors.py	642 B	-rw-r--r--	2023-02-14 03:31
file_proxy.py	1.64 KB	-rw-r--r--	2023-02-14 03:31
filesize.py	2.45 KB	-rw-r--r--	2023-02-14 03:31
highlighter.py	9.36 KB	-rw-r--r--	2023-02-14 03:31
json.py	4.9 KB	-rw-r--r--	2023-02-14 03:31
jupyter.py	3.15 KB	-rw-r--r--	2023-02-14 03:31
layout.py	13.62 KB	-rw-r--r--	2023-02-14 03:31
live.py	13.84 KB	-rw-r--r--	2023-02-14 03:31
live_render.py	3.57 KB	-rw-r--r--	2023-02-14 03:31
logging.py	11.61 KB	-rw-r--r--	2023-02-14 03:31
markdown.py	21.84 KB	-rw-r--r--	2023-02-14 03:31
markup.py	7.98 KB	-rw-r--r--	2023-02-14 03:31
measure.py	5.18 KB	-rw-r--r--	2023-02-14 03:31
padding.py	4.84 KB	-rw-r--r--	2023-02-14 03:31
pager.py	828 B	-rw-r--r--	2023-02-14 03:31
palette.py	3.21 KB	-rw-r--r--	2023-02-14 03:31
panel.py	10.33 KB	-rw-r--r--	2023-02-14 03:31
pretty.py	36.47 KB	-rw-r--r--	2023-02-14 03:31
progress.py	58.27 KB	-rw-r--r--	2023-02-14 03:31
progress_bar.py	7.97 KB	-rw-r--r--	2023-02-14 03:31
prompt.py	11.03 KB	-rw-r--r--	2023-02-14 03:31
protocol.py	1.33 KB	-rw-r--r--	2023-02-14 03:31
py.typed	0 B	-rw-r--r--	2023-02-14 03:31
region.py	166 B	-rw-r--r--	2023-02-14 03:31
repr.py	4.32 KB	-rw-r--r--	2023-02-14 03:31
rule.py	4.48 KB	-rw-r--r--	2023-02-14 03:31
scope.py	2.76 KB	-rw-r--r--	2023-02-14 03:31
screen.py	1.54 KB	-rw-r--r--	2023-02-14 03:31
segment.py	23.63 KB	-rw-r--r--	2023-02-14 03:31
spinner.py	4.24 KB	-rw-r--r--	2023-02-14 03:31
status.py	4.32 KB	-rw-r--r--	2023-02-14 03:31
style.py	25.71 KB	-rw-r--r--	2023-02-14 03:31
styled.py	1.21 KB	-rw-r--r--	2023-02-14 03:31
syntax.py	34.05 KB	-rw-r--r--	2023-02-14 03:31
table.py	38.72 KB	-rw-r--r--	2023-02-14 03:31
terminal_theme.py	3.29 KB	-rw-r--r--	2023-02-14 03:31
text.py	44.6 KB	-rw-r--r--	2023-02-14 03:31
theme.py	3.69 KB	-rw-r--r--	2023-02-14 03:31
themes.py	102 B	-rw-r--r--	2023-02-14 03:31
traceback.py	28.42 KB	-rw-r--r--	2023-02-14 03:31
tree.py	8.9 KB	-rw-r--r--	2023-02-14 03:31

Rename

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