COLORAMA يوفر عبر منصة بسيطة API لطباعة النص محطة الملونة من التطبيقات بيثون.
تستخدم ANSI تسلسل حرف الهروب عادة لإنتاج نص محطة الملونة على أجهزة ماكينتوش ويونكس. يوفر COLORAMA بعض اختصارات لتوليد هذه السلاسل، ويجعلها تعمل على ويندوز أيضا.
وهذا له سعيد الآثار الجانبية التي التطبيقات الموجودة أو المكتبات التي تستخدم بالفعل سلاسل ANSI لإنتاج الناتج الملونة على لينكس أو ماك (على سبيل المثال باستخدام حزم مثل 'termcolor') ويمكن الآن أيضا العمل على ويندوز، وذلك ببساطة عن طريق استيراد وinitialising COLORAMA.
حالة
في التنمية. بعض الميزات، على النحو المبين أدناه، والتي لم تنفذ حتى الآن.
استعمال
Initialisation
يجب أن التطبيقات التهيئة COLORAMA باستخدام:
من COLORAMA الحرف الأول الواردات
فيه ()
إذا كنت على ويندوز، والدعوة إلى '' الحرف الأول () '' سيبدأ تصفية تسلسل ANSI الهروب من أي نص إرسالها إلى المعياري أو ستدير، وسوف تحل محلها مع تدعو يعادل Win32 و.
تدعو '' الحرف الأول () '' له تأثير على منصات أخرى (إلا إذا كنت تستخدم "autoreset '، انظر أدناه) والقصد من ذلك هو أن جميع الطلبات يجب استدعاء الحرف الأول () دون قيد أو شرط، ثم إخراج نص ملون لمجرد يعمل على جميع المنصات.
الناتج الملونة
الطباعة عبر منصة من نص ملون ويمكن بعد ذلك أن يتم:
من فور استيراد COLORAMA، والعودة، نمط
طباعة Fore.RED + "بعض النص أحمر"
Back.GREEN طباعة + مع وجود خلفية خضراء '
طباعة Style.DIM + "وفي النص خافت"
طباعة + Fore.DEFAULT + Back.DEFAULT + Style.DEFAULT
طباعة 'عادت إلى طبيعتها الآن'
أو ببساطة عن طريق يدويا طباعة سلاسل ANSI من التعليمات البرمجية الخاصة بك:
طباعة '/ 033 [31M' + 'بعض النصوص أحمر "
طباعة '/ 033 [30M' # وإعادة تعيين إلى اللون الافتراضي
أو COLORAMA يمكن استخدامها لحسن الحظ بالاشتراك مع المكتبات القائمة ANSI مثل Termcolor (http://pypi.python.org/pypi/termcolor):
# استخدام COLORAMA لجعل Termcolor العمل على ويندوز جدا
من COLORAMA الحرف الأول الواردات
فيه ()
# ثم استخدام Termcolor لجميع إخراج النص الملون
من termcolor استيراد ملونة
طباعة الملونة ('مرحبا، العالم!'، 'الأخضر'، 'on_red')
تتوفر الثوابت تنسيق فيما يلي:
الصدارة: الأسود والأحمر والأخضر والأصفر والأزرق والأرجواني والأزرق والأبيض، والتقصير.
مرة أخرى: الأسود والأحمر والأخضر والأصفر والأزرق والأرجواني والأزرق والأبيض، والتقصير.
نمط: DIM، NORMAL، مشرق، RESET_ALL
Style.RESET_ALL يعيد المقدمة والخلفية والسطوع. سوف COLORAMA تنفيذ هذا إعادة تلقائيا عند الخروج برنامج (لم تنفذ).
Autoreset
لم تنفذ
إذا وجدت نفسك مرارا إرسال تسلسل إعادة تعيين لإيقاف يتغير لونها في نهاية كل الطباعة، ثم الحرف الأول (autoreset = True) إلى أتمتة ما يلي:
من COLORAMA الحرف الأول الواردات
الحرف الأول (autoreset = صحيح)
طباعة Fore.RED + "بعض النص أحمر"
طباعة 'تلقائيا إلى اللون الافتراضي مرة أخرى "
دون التفاف المعياري
COLORAMA يعمل عن طريق التفاف المعياري وستدير مع الكائنات الوكيل، الذي تجاوز الكتابة () للقيام بعملهم. وذلك باستخدام الحرف الأول (autoreset = صحيح) قيام بذلك التفاف على جميع المنابر، وليس مجرد ويندوز.
إذا كانت هذه الكائنات الوكيل التفاف المعياري وستدير تسبب لك المشاكل، ثم وهذا يمكن تعطيل باستخدام الحرف الأول (لف = الكاذبة) (لم تنفذ)، وبدلا من ذلك يمكنك الوصول COLORAMA في AnsiToWin32 الوكيل مباشرة. وسوف ترسل أي وصول السمة على هذا الكائن إلى تيار فإنه يلتف، بصرف النظر عن. اكتب ()، والتي على ويندوز يتم تجاوز لأداء أول ANSI إلى Win32 والتحويل على النص:
من COLORAMA الحرف الأول الاستيراد، AnsiToWin32
الحرف الأول (لف = خطأ)
تيار = AnsiToWin32 (sys.stderr)
طباعة >> تيار، "النص الأزرق على ستدير" Fore.BLUE +
تنمية
الاختبارات تتطلب وحدة وهمية مايكل فوورد و. لقد تم استخدام nosetests لتشغيل الاختبارات على الرغم من أنها قد تعمل دون ذلك، وذلك باستخدام:
colorama.tests بيثون م <وحدة>
ما هو الجديد في هذا الإصدار:.
وأضاف بعض الوثائق لتحديد المواقع المؤشر وشاشة واضحة لالتمهيدي. أضف 'reinit "وظائف" deinit "، كما اقترح تشارلز FOL ورومانوف DA.
ما هو الجديد في الإصدار 0.1.18:
إصلاح README (لا مثل ATTR كما Fore.DEFAULT، الخ)، يرجى أوردته nodakai.
ما هو الجديد في الإصدار 0.1.17:
منع طباعة رموز ANSI القمامة على تثبيت مع نقطة
ما هو الجديد في الإصدار 0.1.16:
إعادة تحميل لتصحيح الخطأ السابق. جعل النظيفة الآن يزيل البيان القديم.
ما هو الجديد في الإصدار 0.1.15:
إصلاح python3 عدم التوافق يرجى ذكرت غونتر Kolousek
ما هو الجديد في الإصدار 0.1.14:
إصلاح إعادة ترميز يصعب الألوان البيضاء والسوداء. Fore.RESET، Back.RESET وStyle.RESET_ALL تعود الآن إلى الألوان كما كانت عند الحرف الأول () كان يسمى. بعض الدروس المستفادة نأمل حول اختبار قبل أن يفرج عنه.
ما هو الجديد في الإصدار 0.1.13:
الإصدار السابق كانت مكسورة تماما (لا يتضمن أي المصدر). عفوا مزدوجة.
ما هو الجديد في الإصدار 0.1.10:
وقف محاكاة النص 'مشرق' مع خلفيات مشرق. عرض النص «طبيعية» باستخدام الصدارة العادية وندوز win32 بدلا من مشرق. انخفاض الدعم للنص "قاتمة".
ما هو الجديد في الإصدار 0.1.9:
إصلاح التوافق مع بيثون 2.5 والإصدارات السابقة إزالة التبعية setup.py على setuptools، يستخدم الآن distutils stdlib
المتطلبات:
بيثون
لم يتم العثور على التعليقات