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

from typing import Union

from .align import AlignMethod
from .cells import cell_len, set_cell_size
from .console import Console, ConsoleOptions, RenderResult
from .jupyter import JupyterMixin
from .measure import Measurement
from .style import Style
from .text import Text

class Rule(JupyterMixin):
    """A console renderable to draw a horizontal rule (line).

Args:
        title (Union[str, Text], optional): Text to render in the rule. Defaults to "".
        characters (str, optional): Character(s) used to draw the line. Defaults to "─".
        style (StyleType, optional): Style of Rule. Defaults to "rule.line".
        end (str, optional): Character at end of Rule. defaults to "\\\\n"
        align (str, optional): How to align the title, one of "left", "center", or "right". Defaults to "center".
    """

def __init__(
        self,
        title: Union[str, Text] = "",
        *,
        characters: str = "─",
        style: Union[str, Style] = "rule.line",
        end: str = "\n",
        align: AlignMethod = "center",
    ) -> None:
        if cell_len(characters) < 1:
            raise ValueError(
                "'characters' argument must have a cell width of at least 1"
            )
        if align not in ("left", "center", "right"):
            raise ValueError(
                f'invalid value for align, expected "left", "center", "right" (not {align!r})'
            )
        self.title = title
        self.characters = characters
        self.style = style
        self.end = end
        self.align = align

def __repr__(self) -> str:
        return f"Rule({self.title!r}, {self.characters!r})"

def __rich_console__(
        self, console: Console, options: ConsoleOptions
    ) -> RenderResult:
        width = options.max_width

characters = (
            "-"
            if (options.ascii_only and not self.characters.isascii())
            else self.characters
        )

chars_len = cell_len(characters)
        if not self.title:
            yield self._rule_line(chars_len, width)
            return

if isinstance(self.title, Text):
            title_text = self.title
        else:
            title_text = console.render_str(self.title, style="rule.text")

title_text.plain = title_text.plain.replace("\n", " ")
        title_text.expand_tabs()

required_space = 4 if self.align == "center" else 2
        truncate_width = max(0, width - required_space)
        if not truncate_width:
            yield self._rule_line(chars_len, width)
            return

rule_text = Text(end=self.end)
        if self.align == "center":
            title_text.truncate(truncate_width, overflow="ellipsis")
            side_width = (width - cell_len(title_text.plain)) // 2
            left = Text(characters * (side_width // chars_len + 1))
            left.truncate(side_width - 1)
            right_length = width - cell_len(left.plain) - cell_len(title_text.plain)
            right = Text(characters * (side_width // chars_len + 1))
            right.truncate(right_length)
            rule_text.append(left.plain + " ", self.style)
            rule_text.append(title_text)
            rule_text.append(" " + right.plain, self.style)
        elif self.align == "left":
            title_text.truncate(truncate_width, overflow="ellipsis")
            rule_text.append(title_text)
            rule_text.append(" ")
            rule_text.append(characters * (width - rule_text.cell_len), self.style)
        elif self.align == "right":
            title_text.truncate(truncate_width, overflow="ellipsis")
            rule_text.append(characters * (width - title_text.cell_len - 1), self.style)
            rule_text.append(" ")
            rule_text.append(title_text)

rule_text.plain = set_cell_size(rule_text.plain, width)
        yield rule_text

def _rule_line(self, chars_len: int, width: int) -> Text:
        rule_text = Text(self.characters * ((width // chars_len) + 1), self.style)
        rule_text.truncate(width)
        rule_text.plain = set_cell_size(rule_text.plain, width)
        return rule_text

def __rich_measure__(
        self, console: Console, options: ConsoleOptions
    ) -> Measurement:
        return Measurement(1, 1)

if __name__ == "__main__":  # pragma: no cover
    import sys

from rich.console import Console

try:
        text = sys.argv[1]
    except IndexError:
        text = "Hello, World"
    console = Console()
    console.print(Rule(title=text))

console = Console()
    console.print(Rule("foo"), width=4)