draw lines package

Ringkasan

Modul Python untuk menggambar garis gaya dan berwarna di terminal. Utilitas ini memungkinkan kustomisasi gaya, warna, dan penentuan posisi teks, menjadikannya alat yang serba guna untuk meningkatkan output aplikasi CLI.

Fitur

• Posisi teks yang dapat disesuaikan: kiri, kanan, atau tengah.
• Dukungan untuk berbagai warna dan gaya teks termasuk tebal.
• Lebar dan bantalan garis yang dapat disesuaikan.
• Menggunakan colorama untuk penanganan warna dan gaya, memastikan kompatibilitas di berbagai sistem operasi.

Instalasi

pip install wolfsoftware.drawlines

Penggunaan

Fungsi utama disediakan oleh fungsi draw_line , yang dapat digunakan untuk membuat garis di terminal dengan atau tanpa teks.

Tanda Tangan Fungsi

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

Contoh

1. Baris sederhana dengan pengaturan default

 from your_module import draw_line

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

Keluaran

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

2. Baris dengan teks terpusat dan warna khusus

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

Keluaran

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

Jika Anda mengatur fill_char=' ' Anda hanya akan mendapatkan teks terpusat tanpa baris.

3. Baris dengan teks yang selaras kiri dan karakter pengisian kustom

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

Keluaran

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

Kustomisasi

Bagian ini memberikan detail tentang bagaimana Anda dapat menyesuaikan parameter fungsi draw_line . Di bawah ini adalah tabel yang mencantumkan setiap parameter, nilai default, tujuan, dan nilai yang diizinkan:

Nama	Nilai default	Tujuan	Nilai yang diizinkan
teks	''	Setiap string yang ingin Anda tampilkan di dalam baris.	String apapun
posisi	'tengah'	Di mana menempatkan teks.	'kiri', 'tengah', 'kanan'
fill_char	'-'	Karakter untuk digunakan saat menggambar garis. Jika lebih dari satu diberikan, hanya yang pertama digunakan.	Setiap karakter tunggal
left_pad	2	Berapa banyak fill_chars untuk digunakan sebagai awalan saat menyelaraskan teks yang tersisa.	Bilangan bulat positif apapun
right_pad	2	Berapa banyak fill_chars untuk digunakan sebagai postfix saat menyelaraskan teks dengan benar.	Bilangan bulat positif apapun
lebar	-1	Seberapa lebar untuk menarik garis. Default ke lebar terminal dikurangi satu jika tidak ditentukan.	Bilangan bulat apa pun; -1 untuk lebar terminal minus 1
warna	''	Warna apa untuk membuat teks.	'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'
berani	PALSU	Haruskah teks berani. Ini dapat digunakan dengan atau tanpa warna yang ditentukan.	Benar, salah

Jika Anda menambahkan BOLD ke warna, itu harus datang setelah nama warna. EB Cyan+Bold Not Bold+Cyan karena ini akan menyebabkan pengecualian dilemparkan.