X-Git-Url: https://wannabe.guru.org/gitweb/?a=blobdiff_plain;f=text_utils.py;h=f04c61813ef227c4bfe356f42d08c59f2234132c;hb=532df2c5b57c7517dfb3dddd8c1358fbadf8baf3;hp=17ac64472e2c8e944335e656de331f8b60e53862;hpb=d2e437a04124fa3c6e3175205f943769ba443393;p=python_utils.git diff --git a/text_utils.py b/text_utils.py index 17ac644..f04c618 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,26 +320,53 @@ 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: + 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: - return '' + line_char = '-' + begin = '[' + end = ']' + return line_char * left + begin + ' ' + title + ' ' + end + line_char * right def box(