draw lines package

Descripción general

Un módulo de pitón para dibujar líneas de estilo y color en la terminal. Esta utilidad permite la personalización de estilos de línea, colores y posicionamiento de texto, lo que lo convierte en una herramienta versátil para mejorar la salida de las aplicaciones CLI.

Características

• Posiciones de texto personalizables: izquierda, derecha o centro.
• Soporte para varios colores y estilos de texto, incluido Bold.
• Ancho de línea ajustable y relleno.
• Utiliza colorama para el manejo de color y estilo, asegurando la compatibilidad en diferentes sistemas operativos.

Instalación

pip install wolfsoftware.drawlines

Uso

La funcionalidad principal es proporcionada por la función draw_line , que puede usarse para crear líneas en el terminal con o sin texto.

Firma de función

 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.
    """

Ejemplos

1. Línea simple con configuración predeterminada

 from your_module import draw_line

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

Producción

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

2. Línea con texto centrado y color personalizado

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

Producción

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

Si establece el fill_char=' ' simplemente obtendrá texto centrado sin línea.

3. Línea con texto alineado con la izquierda y carácter de relleno personalizado

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

Producción

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

Personalización

Esta sección proporciona detalles sobre cómo puede personalizar los parámetros de la función draw_line . A continuación se muestra una tabla que enumera cada parámetro, su valor predeterminado, propósito y valores permitidos:

Nombre	Valor predeterminado	Objetivo	Valores permitidos
texto	''	Cualquier cadena que desee mostrar dentro de la línea.	Cualquier cadena
posición	'centro'	Donde colocar el texto.	'izquierda', 'centro', 'derecha'
relleno	'-'	El personaje a usar al dibujar la línea. Si se da más de uno, solo se usa el primero.	Cualquier personaje
Left_pad	2	¿Cuántos relleno_chars usar como prefijo al alinear el texto que queda?	Cualquier entero positivo
right_pad	2	¿Cuántos relleno_chars usar como postfix al alinear el texto correcto?	Cualquier entero positivo
ancho	-1	Qué amplio dibujar la línea. El valor predeterminado al ancho del terminal menos uno si no se especifica.	Cualquier entero; -1 para el ancho terminal menos 1
color	''	De qué color hacer el texto.	'Bold', 'negro', 'azul', 'cyan', 'verde', 'gris', 'magenta', 'rojo', 'blanco', 'amarillo', 'negro+negrita', 'azul+negrita', 'cian+negrita', 'verde+negrita', 'gris+negrita', 'magenta+audaz', 'rojo+negrita', 'blanca+blanca' amarillo+amarillo ''
atrevido	FALSO	Si el texto es audaz. Esto se puede usar con o sin un color definido.	Verdadero, falso

Si está agregando en negrita a un color , debe venir después del nombre del color. EB Cyan+Bold no Bold+Cyan, ya que esto causará una excepción.