draw lines package تنزيل - draw lines package تنزيل رمز المصدر

draw lines package

كود الذكاء الاصطناعي

v0.1.3

تنزيل

ملخص

وحدة بيثون لرسم الخطوط المصممة والملونة في المحطة. تتيح هذه الأداة المساعدة تخصيص أنماط الخط والألوان وتحديد المواقع النصية ، مما يجعلها أداة متعددة الاستخدامات لتعزيز إخراج تطبيقات CLI.

سمات

مواضع نصية قابلة للتخصيص: يسار ، يمين ، أو الوسط.
دعم لألوان وأنماط النص المختلفة بما في ذلك Bold.
عرض خط قابل للتعديل والحشو.
يستخدم colorama لمعالجة الألوان والأناقة ، وضمان التوافق عبر أنظمة التشغيل المختلفة.

تثبيت

pip install wolfsoftware.drawlines

الاستخدام

يتم توفير الوظيفة الرئيسية بواسطة وظيفة draw_line ، والتي يمكن استخدامها لإنشاء خطوط في المحطة مع أو بدون نص.

توقيع الوظيفة

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

أمثلة

1. خط بسيط مع الإعدادات الافتراضية

 from your_module import draw_line

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

الإخراج

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

2. خط مع النص المتمركز واللون المخصص

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

الإخراج

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

إذا قمت بتعيين fill_char=' ' سوف تحصل ببساطة على نص مركز بدون سطر.

3. خط مع نص محاذاة وملء مخصص

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

الإخراج

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

التخصيص

يوفر هذا القسم تفاصيل حول كيفية تخصيص معلمات دالة draw_line . فيما يلي جدول يسرد كل معلمة ، قيمتها الافتراضية والغرض والقيم المسموح بها:

اسم	القيمة الافتراضية	غاية	القيم المسموح بها
نص	'' '	أي سلسلة تريد عرضها داخل السطر.	أي سلسلة
موضع	'مركز'	أين تضع النص.	"اليسار" ، "المركز" ، "يمين"
fill_char	'-'	الشخصية لاستخدامها عند رسم الخط. إذا تم إعطاء أكثر من واحد ، يتم استخدام الأول فقط.	أي حرف واحد
left_pad	2	كم عدد fill_chars لاستخدامها كبادئة عند محاذاة النص المتبقي.	أي عدد صحيح إيجابي
يمين	2	كم عدد fill_chars لاستخدامه كبريد عند محاذاة النص بشكل صحيح.	أي عدد صحيح إيجابي
عرض	-1	كيف واسعة لرسم الخط. الإعدادات الافتراضية لعرض المحطة ناقص واحد إن لم يتم تحديده.	أي عدد صحيح. -1 للعرض الطرفي ناقص 1
لون	'' '	ما هو لون صنع النص.	"Bold" ، "Black" ، "Blue" ، "Cyan" ، "Green" ، "Gray" ، "Magenta" ، "Red" ، "White" ، "Yellow" ، "Black+Bold" ، "Blue+Bold" ، "Cyan+Bold" ، "Green+Bold" ، "Gray+Bold" ، "Magenta+Bold"
عريض	خطأ شنيع	هل يجب أن يكون النص جريئًا. يمكن استخدام هذا مع أو بدون لون محدد.	صحيح ، خطأ