Gecko [ www.jobworksschool.com ]

Name	Size	Permission	Date
__pycache__	[ DIR ]	drwxr-xr-x	2025-08-05 17:02
__init__.py	5.92 KB	-rw-r--r--	2024-03-04 23:07
__main__.py	8.14 KB	-rw-r--r--	2024-03-04 23:07
_cell_widths.py	9.97 KB	-rw-r--r--	2024-03-04 23:07
_emoji_codes.py	136.95 KB	-rw-r--r--	2024-03-04 23:07
_emoji_replace.py	1.04 KB	-rw-r--r--	2024-03-04 23:07
_export_format.py	2.08 KB	-rw-r--r--	2024-03-04 23:07
_extension.py	241 B	-rw-r--r--	2024-03-04 23:07
_fileno.py	799 B	-rw-r--r--	2024-03-04 23:07
_inspect.py	9.47 KB	-rw-r--r--	2024-03-04 23:07
_log_render.py	3.14 KB	-rw-r--r--	2024-03-04 23:07
_loop.py	1.21 KB	-rw-r--r--	2024-03-04 23:07
_null_file.py	1.35 KB	-rw-r--r--	2024-03-04 23:07
_palettes.py	6.9 KB	-rw-r--r--	2024-03-04 23:07
_pick.py	423 B	-rw-r--r--	2024-03-04 23:07
_ratio.py	5.33 KB	-rw-r--r--	2024-03-04 23:07
_spinners.py	19.45 KB	-rw-r--r--	2024-03-04 23:07
_stack.py	351 B	-rw-r--r--	2024-03-04 23:07
_timer.py	417 B	-rw-r--r--	2024-03-04 23:07
_win32_console.py	22.25 KB	-rw-r--r--	2024-03-04 23:07
_windows.py	1.86 KB	-rw-r--r--	2024-03-04 23:07
_windows_renderer.py	2.69 KB	-rw-r--r--	2024-03-04 23:07
_wrap.py	3.32 KB	-rw-r--r--	2024-03-04 23:07
abc.py	878 B	-rw-r--r--	2024-03-04 23:07
align.py	10.08 KB	-rw-r--r--	2024-03-04 23:07
ansi.py	6.74 KB	-rw-r--r--	2024-03-04 23:07
bar.py	3.19 KB	-rw-r--r--	2024-03-04 23:07
box.py	10.53 KB	-rw-r--r--	2024-03-04 23:07
cells.py	4.67 KB	-rw-r--r--	2024-03-04 23:07
color.py	17.8 KB	-rw-r--r--	2024-03-04 23:07
color_triplet.py	1.03 KB	-rw-r--r--	2024-03-04 23:07
columns.py	6.96 KB	-rw-r--r--	2024-03-04 23:07
console.py	96.78 KB	-rw-r--r--	2024-03-04 23:07
constrain.py	1.26 KB	-rw-r--r--	2024-03-04 23:07
containers.py	5.37 KB	-rw-r--r--	2024-03-04 23:07
control.py	6.45 KB	-rw-r--r--	2024-03-04 23:07
default_styles.py	7.86 KB	-rw-r--r--	2024-03-04 23:07
diagnose.py	924 B	-rw-r--r--	2024-03-04 23:07
emoji.py	2.41 KB	-rw-r--r--	2024-03-04 23:07
errors.py	642 B	-rw-r--r--	2024-03-04 23:07
file_proxy.py	1.64 KB	-rw-r--r--	2024-03-04 23:07
filesize.py	2.45 KB	-rw-r--r--	2024-03-04 23:07
highlighter.py	9.36 KB	-rw-r--r--	2024-03-04 23:07
json.py	4.9 KB	-rw-r--r--	2024-03-04 23:07
jupyter.py	3.15 KB	-rw-r--r--	2024-03-04 23:07
layout.py	13.62 KB	-rw-r--r--	2024-03-04 23:07
live.py	13.94 KB	-rw-r--r--	2024-03-04 23:07
live_render.py	3.57 KB	-rw-r--r--	2024-03-04 23:07
logging.py	11.61 KB	-rw-r--r--	2024-03-04 23:07
markdown.py	25.55 KB	-rw-r--r--	2024-03-04 23:07
markup.py	8.23 KB	-rw-r--r--	2024-03-04 23:07
measure.py	5.18 KB	-rw-r--r--	2024-03-04 23:07
padding.py	4.84 KB	-rw-r--r--	2024-03-04 23:07
pager.py	828 B	-rw-r--r--	2024-03-04 23:07
palette.py	3.21 KB	-rw-r--r--	2024-03-04 23:07
panel.py	10.45 KB	-rw-r--r--	2024-03-04 23:07
pretty.py	34.97 KB	-rw-r--r--	2024-03-04 23:07
progress.py	58.3 KB	-rw-r--r--	2024-03-04 23:07
progress_bar.py	7.97 KB	-rw-r--r--	2024-03-04 23:07
prompt.py	11.03 KB	-rw-r--r--	2024-03-04 23:07
protocol.py	1.33 KB	-rw-r--r--	2024-03-04 23:07
py.typed	0 B	-rw-r--r--	2024-03-04 23:07
region.py	166 B	-rw-r--r--	2024-03-04 23:07
repr.py	4.32 KB	-rw-r--r--	2024-03-04 23:07
rule.py	4.48 KB	-rw-r--r--	2024-03-04 23:07
scope.py	2.76 KB	-rw-r--r--	2024-03-04 23:07
screen.py	1.54 KB	-rw-r--r--	2024-03-04 23:07
segment.py	23.64 KB	-rw-r--r--	2024-03-04 23:07
spinner.py	4.24 KB	-rw-r--r--	2024-03-04 23:07
status.py	4.32 KB	-rw-r--r--	2024-03-04 23:07
style.py	26.44 KB	-rw-r--r--	2024-03-04 23:07
styled.py	1.21 KB	-rw-r--r--	2024-03-04 23:07
syntax.py	34.54 KB	-rw-r--r--	2024-03-04 23:07
table.py	38.71 KB	-rw-r--r--	2024-03-04 23:07
terminal_theme.py	3.29 KB	-rw-r--r--	2024-03-04 23:07
text.py	46.19 KB	-rw-r--r--	2024-03-04 23:07
theme.py	3.69 KB	-rw-r--r--	2024-03-04 23:07
themes.py	102 B	-rw-r--r--	2024-03-04 23:07
traceback.py	28.84 KB	-rw-r--r--	2024-03-04 23:07
tree.py	8.89 KB	-rw-r--r--	2024-03-04 23:07

Rename

import sys
from typing import TYPE_CHECKING, Iterable, List

if sys.version_info >= (3, 8):
    from typing import Literal
else:
    from typing_extensions import Literal  # pragma: no cover

from ._loop import loop_last

if TYPE_CHECKING:
    from rich.console import ConsoleOptions

class Box:
    """Defines characters to render boxes.

┌─┬┐ top
    │ ││ head
    ├─┼┤ head_row
    │ ││ mid
    ├─┼┤ row
    ├─┼┤ foot_row
    │ ││ foot
    └─┴┘ bottom

Args:
        box (str): Characters making up box.
        ascii (bool, optional): True if this box uses ascii characters only. Default is False.
    """

def __init__(self, box: str, *, ascii: bool = False) -> None:
        self._box = box
        self.ascii = ascii
        line1, line2, line3, line4, line5, line6, line7, line8 = box.splitlines()
        # top
        self.top_left, self.top, self.top_divider, self.top_right = iter(line1)
        # head
        self.head_left, _, self.head_vertical, self.head_right = iter(line2)
        # head_row
        (
            self.head_row_left,
            self.head_row_horizontal,
            self.head_row_cross,
            self.head_row_right,
        ) = iter(line3)

# mid
        self.mid_left, _, self.mid_vertical, self.mid_right = iter(line4)
        # row
        self.row_left, self.row_horizontal, self.row_cross, self.row_right = iter(line5)
        # foot_row
        (
            self.foot_row_left,
            self.foot_row_horizontal,
            self.foot_row_cross,
            self.foot_row_right,
        ) = iter(line6)
        # foot
        self.foot_left, _, self.foot_vertical, self.foot_right = iter(line7)
        # bottom
        self.bottom_left, self.bottom, self.bottom_divider, self.bottom_right = iter(
            line8
        )

def __repr__(self) -> str:
        return "Box(...)"

def __str__(self) -> str:
        return self._box

def substitute(self, options: "ConsoleOptions", safe: bool = True) -> "Box":
        """Substitute this box for another if it won't render due to platform issues.

Args:
            options (ConsoleOptions): Console options used in rendering.
            safe (bool, optional): Substitute this for another Box if there are known problems
                displaying on the platform (currently only relevant on Windows). Default is True.

Returns:
            Box: A different Box or the same Box.
        """
        box = self
        if options.legacy_windows and safe:
            box = LEGACY_WINDOWS_SUBSTITUTIONS.get(box, box)
        if options.ascii_only and not box.ascii:
            box = ASCII
        return box

def get_plain_headed_box(self) -> "Box":
        """If this box uses special characters for the borders of the header, then
        return the equivalent box that does not.

Returns:
            Box: The most similar Box that doesn't use header-specific box characters.
                If the current Box already satisfies this criterion, then it's returned.
        """
        return PLAIN_HEADED_SUBSTITUTIONS.get(self, self)

def get_top(self, widths: Iterable[int]) -> str:
        """Get the top of a simple box.

Args:
            widths (List[int]): Widths of columns.

Returns:
            str: A string of box characters.
        """

parts: List[str] = []
        append = parts.append
        append(self.top_left)
        for last, width in loop_last(widths):
            append(self.top * width)
            if not last:
                append(self.top_divider)
        append(self.top_right)
        return "".join(parts)

def get_row(
        self,
        widths: Iterable[int],
        level: Literal["head", "row", "foot", "mid"] = "row",
        edge: bool = True,
    ) -> str:
        """Get the top of a simple box.

Args:
            width (List[int]): Widths of columns.

Returns:
            str: A string of box characters.
        """
        if level == "head":
            left = self.head_row_left
            horizontal = self.head_row_horizontal
            cross = self.head_row_cross
            right = self.head_row_right
        elif level == "row":
            left = self.row_left
            horizontal = self.row_horizontal
            cross = self.row_cross
            right = self.row_right
        elif level == "mid":
            left = self.mid_left
            horizontal = " "
            cross = self.mid_vertical
            right = self.mid_right
        elif level == "foot":
            left = self.foot_row_left
            horizontal = self.foot_row_horizontal
            cross = self.foot_row_cross
            right = self.foot_row_right
        else:
            raise ValueError("level must be 'head', 'row' or 'foot'")

parts: List[str] = []
        append = parts.append
        if edge:
            append(left)
        for last, width in loop_last(widths):
            append(horizontal * width)
            if not last:
                append(cross)
        if edge:
            append(right)
        return "".join(parts)

def get_bottom(self, widths: Iterable[int]) -> str:
        """Get the bottom of a simple box.

Args:
            widths (List[int]): Widths of columns.

Returns:
            str: A string of box characters.
        """

parts: List[str] = []
        append = parts.append
        append(self.bottom_left)
        for last, width in loop_last(widths):
            append(self.bottom * width)
            if not last:
                append(self.bottom_divider)
        append(self.bottom_right)
        return "".join(parts)

# fmt: off
ASCII: Box = Box(
    "+--+\n"
    "| ||\n"
    "|-+|\n"
    "| ||\n"
    "|-+|\n"
    "|-+|\n"
    "| ||\n"
    "+--+\n",
    ascii=True,
)

ASCII2: Box = Box(
    "+-++\n"
    "| ||\n"
    "+-++\n"
    "| ||\n"
    "+-++\n"
    "+-++\n"
    "| ||\n"
    "+-++\n",
    ascii=True,
)

ASCII_DOUBLE_HEAD: Box = Box(
    "+-++\n"
    "| ||\n"
    "+=++\n"
    "| ||\n"
    "+-++\n"
    "+-++\n"
    "| ||\n"
    "+-++\n",
    ascii=True,
)

SQUARE: Box = Box(
    "┌─┬┐\n"
    "│ ││\n"
    "├─┼┤\n"
    "│ ││\n"
    "├─┼┤\n"
    "├─┼┤\n"
    "│ ││\n"
    "└─┴┘\n"
)

SQUARE_DOUBLE_HEAD: Box = Box(
    "┌─┬┐\n"
    "│ ││\n"
    "╞═╪╡\n"
    "│ ││\n"
    "├─┼┤\n"
    "├─┼┤\n"
    "│ ││\n"
    "└─┴┘\n"
)

MINIMAL: Box = Box(
    "  ╷ \n"
    "  │ \n"
    "╶─┼╴\n"
    "  │ \n"
    "╶─┼╴\n"
    "╶─┼╴\n"
    "  │ \n"
    "  ╵ \n"
)

MINIMAL_HEAVY_HEAD: Box = Box(
    "  ╷ \n"
    "  │ \n"
    "╺━┿╸\n"
    "  │ \n"
    "╶─┼╴\n"
    "╶─┼╴\n"
    "  │ \n"
    "  ╵ \n"
)

MINIMAL_DOUBLE_HEAD: Box = Box(
    "  ╷ \n"
    "  │ \n"
    " ═╪ \n"
    "  │ \n"
    " ─┼ \n"
    " ─┼ \n"
    "  │ \n"
    "  ╵ \n"
)

SIMPLE: Box = Box(
    "    \n"
    "    \n"
    " ── \n"
    "    \n"
    "    \n"
    " ── \n"
    "    \n"
    "    \n"
)

SIMPLE_HEAD: Box = Box(
    "    \n"
    "    \n"
    " ── \n"
    "    \n"
    "    \n"
    "    \n"
    "    \n"
    "    \n"
)

SIMPLE_HEAVY: Box = Box(
    "    \n"
    "    \n"
    " ━━ \n"
    "    \n"
    "    \n"
    " ━━ \n"
    "    \n"
    "    \n"
)

HORIZONTALS: Box = Box(
    " ── \n"
    "    \n"
    " ── \n"
    "    \n"
    " ── \n"
    " ── \n"
    "    \n"
    " ── \n"
)

ROUNDED: Box = Box(
    "╭─┬╮\n"
    "│ ││\n"
    "├─┼┤\n"
    "│ ││\n"
    "├─┼┤\n"
    "├─┼┤\n"
    "│ ││\n"
    "╰─┴╯\n"
)

HEAVY: Box = Box(
    "┏━┳┓\n"
    "┃ ┃┃\n"
    "┣━╋┫\n"
    "┃ ┃┃\n"
    "┣━╋┫\n"
    "┣━╋┫\n"
    "┃ ┃┃\n"
    "┗━┻┛\n"
)

HEAVY_EDGE: Box = Box(
    "┏━┯┓\n"
    "┃ │┃\n"
    "┠─┼┨\n"
    "┃ │┃\n"
    "┠─┼┨\n"
    "┠─┼┨\n"
    "┃ │┃\n"
    "┗━┷┛\n"
)

HEAVY_HEAD: Box = Box(
    "┏━┳┓\n"
    "┃ ┃┃\n"
    "┡━╇┩\n"
    "│ ││\n"
    "├─┼┤\n"
    "├─┼┤\n"
    "│ ││\n"
    "└─┴┘\n"
)

DOUBLE: Box = Box(
    "╔═╦╗\n"
    "║ ║║\n"
    "╠═╬╣\n"
    "║ ║║\n"
    "╠═╬╣\n"
    "╠═╬╣\n"
    "║ ║║\n"
    "╚═╩╝\n"
)

DOUBLE_EDGE: Box = Box(
    "╔═╤╗\n"
    "║ │║\n"
    "╟─┼╢\n"
    "║ │║\n"
    "╟─┼╢\n"
    "╟─┼╢\n"
    "║ │║\n"
    "╚═╧╝\n"
)

MARKDOWN: Box = Box(
    "    \n"
    "| ||\n"
    "|-||\n"
    "| ||\n"
    "|-||\n"
    "|-||\n"
    "| ||\n"
    "    \n",
    ascii=True,
)
# fmt: on

# Map Boxes that don't render with raster fonts on to equivalent that do
LEGACY_WINDOWS_SUBSTITUTIONS = {
    ROUNDED: SQUARE,
    MINIMAL_HEAVY_HEAD: MINIMAL,
    SIMPLE_HEAVY: SIMPLE,
    HEAVY: SQUARE,
    HEAVY_EDGE: SQUARE,
    HEAVY_HEAD: SQUARE,
}

# Map headed boxes to their headerless equivalents
PLAIN_HEADED_SUBSTITUTIONS = {
    HEAVY_HEAD: SQUARE,
    SQUARE_DOUBLE_HEAD: SQUARE,
    MINIMAL_DOUBLE_HEAD: MINIMAL,
    MINIMAL_HEAVY_HEAD: MINIMAL,
    ASCII_DOUBLE_HEAD: ASCII2,
}

if __name__ == "__main__":  # pragma: no cover
    from rich.columns import Columns
    from rich.panel import Panel

from . import box as box
    from .console import Console
    from .table import Table
    from .text import Text

console = Console(record=True)

BOXES = [
        "ASCII",
        "ASCII2",
        "ASCII_DOUBLE_HEAD",
        "SQUARE",
        "SQUARE_DOUBLE_HEAD",
        "MINIMAL",
        "MINIMAL_HEAVY_HEAD",
        "MINIMAL_DOUBLE_HEAD",
        "SIMPLE",
        "SIMPLE_HEAD",
        "SIMPLE_HEAVY",
        "HORIZONTALS",
        "ROUNDED",
        "HEAVY",
        "HEAVY_EDGE",
        "HEAVY_HEAD",
        "DOUBLE",
        "DOUBLE_EDGE",
        "MARKDOWN",
    ]

console.print(Panel("[bold green]Box Constants", style="green"), justify="center")
    console.print()

columns = Columns(expand=True, padding=2)
    for box_name in sorted(BOXES):
        table = Table(
            show_footer=True, style="dim", border_style="not dim", expand=True
        )
        table.add_column("Header 1", "Footer 1")
        table.add_column("Header 2", "Footer 2")
        table.add_row("Cell", "Cell")
        table.add_row("Cell", "Cell")
        table.box = getattr(box, box_name)
        table.title = Text(f"box.{box_name}", style="magenta")
        columns.add_renderable(table)
    console.print(columns)

# console.save_svg("box.svg")