X-Git-Url: https://wannabe.guru.org/gitweb/?a=blobdiff_plain;f=text_utils.py;h=18a22577d7efef0962f1ba8d65ade4e859ce4e4b;hb=001b734eb651c819d880df1017829bd54d7c16f7;hp=17ac64472e2c8e944335e656de331f8b60e53862;hpb=d2e437a04124fa3c6e3175205f943769ba443393;p=python_utils.git diff --git a/text_utils.py b/text_utils.py index 17ac644..18a2257 100644 --- a/text_utils.py +++ b/text_utils.py @@ -1,6 +1,8 @@ #!/usr/bin/env python3 # -*- coding: utf-8 -*- +# © Copyright 2021-2022, Scott Gasch + """Utilities for dealing with "text".""" import contextlib @@ -318,30 +320,66 @@ class Indenter(contextlib.AbstractContextManager): print(self.pad_prefix + self.padding * self.level + text, end='') -def header(title: str, *, width: int = 80, color: str = ''): +def header( + title: str, + *, + width: Optional[int] = None, + align: Optional[str] = None, + style: Optional[str] = 'solid', +): """ Returns a nice header line with a title. - >>> header('title', width=60, color='') + >>> header('title', width=60, style='ascii') '----[ title ]-----------------------------------------------' """ - w = width - w -= len(string_utils.strip_ansi_sequences(title)) + 4 - if w >= 4: - left = 4 * '-' - right = (w - 4) * '-' - if color != '' and color is not None: - r = reset() - else: - r = '' - return f'{left}[ {color}{title}{r} ]{right}' + if not width: + width = get_console_rows_columns().columns + if not align: + align = 'left' + if not style: + style = 'ascii' + + text_len = len(string_utils.strip_ansi_sequences(title)) + if align == 'left': + left = 4 + right = width - (left + text_len + 4) + elif align == 'right': + right = 4 + left = width - (right + text_len + 4) else: - return '' + left = int((width - (text_len + 4)) / 2) + right = left + while left + text_len + 4 + right < width: + right += 1 + + if style == 'solid': + line_char = '━' + begin = '' + end = '' + elif style == 'dashed': + line_char = '┅' + begin = '' + end = '' + else: + line_char = '-' + begin = '[' + end = ']' + return line_char * left + begin + ' ' + title + ' ' + end + line_char * right def box( title: Optional[str] = None, text: Optional[str] = None, *, width: int = 80, color: str = '' +) -> str: + assert width > 4 + if text is not None: + text = justify_text(text, width=width - 4, alignment='l') + return preformatted_box(title, text, width=width, color=color) + + +def preformatted_box( + title: Optional[str] = None, text: Optional[str] = None, *, width=80, color: str = '' ) -> str: assert width > 4 ret = '' @@ -364,9 +402,9 @@ def box( ) ret += color + '│' + ' ' * w + '│' + rset + '\n' if text is not None: - for line in justify_text(text, width=w - 2, alignment='l').split('\n'): + for line in text.split('\n'): tw = len(string_utils.strip_ansi_sequences(line)) - assert tw < w + assert tw <= w ret += color + '│ ' + rset + line + ' ' * (w - tw - 2) + color + ' │' + rset + '\n' ret += color + '╰' + '─' * w + '╯' + rset + '\n' return ret @@ -390,7 +428,7 @@ def print_box( ╰────╯ """ - print(box(title, text, width=width, color=color), end='') + print(preformatted_box(title, text, width=width, color=color), end='') if __name__ == '__main__':