#!/usr/bin/env python3
# -*- coding: utf-8 -*-
+# © Copyright 2021-2022, Scott Gasch
+
"""Utilities for dealing with "text"."""
import contextlib
import logging
import math
+import os
import re
import sys
from collections import defaultdict
from exec_utils import cmd
- try:
- rows, columns = cmd(
- "stty size",
- timeout_seconds=1.0,
- ).split()
- except Exception as e:
- logger.exception(e)
- raise Exception('Can\'t determine console size?!') from e
- return RowsColumns(int(rows), int(columns))
+ rows: Optional[str] = os.environ.get('LINES', None)
+ cols: Optional[str] = os.environ.get('COLUMNS', None)
+ if not rows or not cols:
+ try:
+ rows, cols = cmd(
+ "stty size",
+ timeout_seconds=1.0,
+ ).split()
+ except Exception:
+ rows = None
+ cols = None
+
+ if rows is None:
+ try:
+ rows = cmd(
+ "tput rows",
+ timeout_seconds=1.0,
+ )
+ except Exception:
+ rows = None
+
+ if cols is None:
+ try:
+ cols = cmd(
+ "tput cols",
+ timeout_seconds=1.0,
+ )
+ except Exception:
+ cols = None
+
+ if not rows or not cols:
+ raise Exception('Can\'t determine console size?!')
+ return RowsColumns(int(rows), int(cols))
def progress_graph(
return string
-def justify_text(text: str, *, width: int = 80, alignment: str = "c") -> str:
+def justify_text(text: str, *, width: int = 80, alignment: str = "c", indent_by: int = 0) -> str:
"""
- Justifies text.
+ Justifies text optionally with initial indentation.
>>> justify_text('This is a test of the emergency broadcast system. This is only a test.',
... width=40, alignment='j') #doctest: +NORMALIZE_WHITESPACE
'This is a test of the emergency\\nbroadcast system. This is only a test.'
"""
- retval = ""
- line = ""
+ retval = ''
+ indent = ''
+ if indent_by > 0:
+ indent += ' ' * indent_by
+ line = indent
+
for word in text.split():
if (
len(string_utils.strip_ansi_sequences(line))
) > width:
line = line[1:]
line = justify_string(line, width=width, alignment=alignment)
- retval = retval + "\n" + line
- line = ""
- line = line + " " + word
+ retval = retval + '\n' + line
+ line = indent
+ line = line + ' ' + word
if len(string_utils.strip_ansi_sequences(line)) > 0:
- retval += "\n" + line[1:]
+ if alignment != 'j':
+ retval += "\n" + justify_string(line[1:], width=width, alignment=alignment)
+ else:
+ retval += "\n" + line[1:]
return retval[1:]
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',
+ color: Optional[str] = None,
+):
"""
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:
+ try:
+ width = get_console_rows_columns().columns
+ except Exception:
+ width = 80
+ 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 = ']'
+ if color:
+ col = color
+ reset_seq = reset()
+ else:
+ col = ''
+ reset_seq = ''
+ return line_char * left + begin + col + ' ' + title + ' ' + reset_seq + 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 = ''
)
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
╰────╯
"""
- print(box(title, text, width=width, color=color), end='')
+ print(preformatted_box(title, text, width=width, color=color), end='')
if __name__ == '__main__':