draw lines package

Überblick

Ein Python -Modul zum Zeichnen von gestymten und farbigen Linien im Terminal. Dieses Dienstprogramm ermöglicht die Anpassung von Linienstilen, Farben und Textpositionierung und macht es zu einem vielseitigen Werkzeug zur Verbesserung der Ausgabe von CLI -Anwendungen.

Merkmale

• Anpassbare Textpositionen: links, rechts oder Mitte.
• Unterstützung für verschiedene Textfarben und -stile, einschließlich mutig.
• Einstellbare Linienbreite und Polsterung.
• Verwendet colorama für Farb- und Stilbehandlungen, um die Kompatibilität für verschiedene Betriebssysteme zu gewährleisten.

Installation

pip install wolfsoftware.drawlines

Verwendung

Die Hauptfunktionalität wird durch die Funktion draw_line bereitgestellt, mit der Zeilen im Terminal mit oder ohne Text erstellt werden können.

Funktionssignatur

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

Beispiele

1. Einfache Linie mit Standardeinstellungen

 from your_module import draw_line

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

Ausgabe

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

2. Zeilen Sie mit zentriertem Text und benutzerdefinierter Farbe aus

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

Ausgabe

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

Wenn Sie den fill_char=' ' festlegen, erhalten Sie einfach einen zentrierten Text ohne Zeile.

3.. Zeilen Sie mit links ausgerichteter Text und benutzerdefiniertem Füllzeichen

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

Ausgabe

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

Anpassung

In diesem Abschnitt werden Details enthält, wie Sie die Funktionsparameter von draw_line anpassen können. Im Folgenden finden Sie eine Tabelle, die jeden Parameter, seinen Standardwert, den Zweck und die zulässigen Werte auflistet:

Name	Standardwert	Zweck	Zulässige Werte
Text	'' '	Jede Zeichenfolge, die Sie in der Zeile anzeigen möchten.	Jede Zeichenfolge
Position	'Center'	Wo kann der Text platziert werden.	'links', 'Mitte', 'rechts'
fill_char	'-' '	Das Zeichen, das beim Zeichnen der Linie verwendet werden soll. Wenn mehr als einer gegeben ist, wird nur der erste verwendet.	Jeder einzelne Zeichen
links_pad	2	Wie viele fill_chars zum Präfix zum Ausrichten des linksgerichteten Textes als Präfix verwendet werden.	Jede positive Ganzzahl
Right_pad	2	Wie viele FILL_CHARS, die Sie als Postfix verwenden können, wenn Sie den Text richtig ausrichten?	Jede positive Ganzzahl
Breite	-1	Wie breit, um die Linie zu zeichnen. Standardeinstellungen zur Breite des Terminals minus eins, wenn nicht angegeben.	Jede ganze Zahl; -1 für die terminale Breite minus 1 1
Farbe	'' '	Welche Farbe, um den Text zu machen.	'mutig', 'schwarz', 'blau', 'cyan', 'grün', 'grau', 'magenta', 'rot', 'weiß', 'gelb', 'schwarz+kühn', 'blau+kühn', 'cyan+bett
deutlich	FALSCH	Sollte der Text mutig sein. Dies kann mit oder ohne definierte Farbe verwendet werden.	Richtig, falsch

Wenn Sie einer Farbe mutig einfügen, muss sie nach dem Farbnamen erfolgen. EB Cyan+BOLD NICHT BOLD+CYAN, da dies eine Ausnahme verursacht, die ausgeworfen werden kann.