draw lines package

Visão geral

Um módulo Python para desenhar linhas de estilo e colorido no terminal. Esse utilitário permite a personalização de estilos de linha, cores e posicionamento de texto, tornando -o uma ferramenta versátil para aprimorar a saída dos aplicativos da CLI.

Características

• Posições de texto personalizáveis: esquerda, direita ou centro.
• Suporte para várias cores e estilos de texto, incluindo BOLD.
• Largura da linha ajustável e preenchimento.
• Usa colorama para manuseio de cor e estilo, garantindo a compatibilidade em diferentes sistemas operacionais.

Instalação

pip install wolfsoftware.drawlines

Uso

A principal funcionalidade é fornecida pela função draw_line , que pode ser usada para criar linhas no terminal com ou sem texto.

Assinatura da função

 def draw_line ( text = '' , position = 'center' , fill_char = '-' , pad = 2 , width = - 1 , color = '' ):
    """
    Draw a line across the terminal with optional text.

    Args:
        text (str): Text to include in the line. Defaults to '' (no text).
        position (str): Position of the text ('left', 'right', 'center'). Defaults to 'center'.
        fill_char (str): Character used to fill the line. Defaults to '-'.
        pad (int): Padding characters around the text. Defaults to 2.
        width (int): Total width of the line; defaults to the terminal width if set to -1.
        color (str): Color and style of the text, e.g., 'red', 'blue+bold'. Defaults to no color.
    """

Exemplos

1. Linha simples com configurações padrão

 from your_module import draw_line

# Draw a simple dashed line
print ( draw_line ())

Saída

------------------------------------------------------------------------------------------

2. Linha com texto centrado e cor personalizada

 # Draw a line with centered text
print ( draw_line ( text = "Hello, World!" , position = 'center' ))

Saída

------------------------------------- Hello, World ! --------------------------------------

Se você definir o fill_char=' ' simplesmente receberá texto centralizado sem linha.

3. Linha com texto alinhado à esquerda e caractere de preenchimento personalizado

 # Draw a line with left-aligned text and asterisk fill character
print ( draw_line ( text = "Left aligned text" , position = 'left' , fill_char = '*' ))

Saída

 ** Left aligned text ********************************************************************* 

Personalização

Esta seção fornece detalhes sobre como você pode personalizar os parâmetros de função draw_line . Abaixo está uma tabela listando cada parâmetro, seu valor padrão, propósito e valores permitidos:

Nome	Valor padrão	Propósito	Valores permitidos
texto	''	Qualquer string que você deseja exibir dentro da linha.	Qualquer string
posição	'centro'	Onde colocar o texto.	'Esquerda', 'Centro', 'Certo'
FILL_CHAR	'-'	O personagem a ser usado ao desenhar a linha. Se mais de um for dado, apenas o primeiro será usado.	Qualquer caractere único
esquerd_pad	2	Quantos preench_chars para usar como prefixo ao alinhar o texto deixado.	Qualquer número inteiro positivo
Right_pad	2	Quantos preench_chars para usar como um postfix ao alinhar o texto certo.	Qualquer número inteiro positivo
largura	-1	Quão largo para desenhar a linha. Padrões para a largura do terminal menos um, se não for especificado.	Qualquer número inteiro; -1 para largura do terminal menos 1
cor	''	Que cor fazer o texto.	'bold', 'black', 'blue', 'cyan', 'green', 'grey', 'magenta', 'red', 'white', 'yellow', 'black+bold', 'blue+bold', 'cyan+bold', 'green+bold', 'grey+bold', 'magenta+bold', 'red+bold', 'white+bold', 'yellow+bold'
audacioso	Falso	O texto deve ser ousado. Isso pode ser usado com ou sem uma cor definida.	Verdadeiro, falso

Se você estiver adicionando ousado a uma cor, ela deve vir após o nome da cor. EB ciano+ousado não em negrito+ciano, pois isso fará com que uma exceção seja lançada.