در colorama API کراس پلت فرم ساده به چاپ متن ترمینال رنگی از برنامه های پایتون فراهم می کند.
ANSI توالی شخصیت فرار معمولا مورد استفاده برای تولید متن ترمینال های رنگی بر روی Mac و یونیکس. Colorama فراهم می کند برخی از کلید های میانبر برای تولید این توالی، و آنها را بر روی ویندوز کار بیش از حد.
این است که خوشحال عوارض جانبی که برنامه های کاربردی و یا کتابخانه های موجود که در حال حاضر استفاده از توالی های ANSI برای تولید خروجی رنگی که بر روی لینوکس یا مکینتاش (به عنوان مثال با استفاده از بسته های مانند 'termcolor') می تواند در حال حاضر نیز بر روی ویندوز کار می کنند، به سادگی با واردات و initialising Colorama.
وضعیت
در حال توسعه. برخی از ویژگی های، که در زیر اشاره شده است، در حال هنوز اجرا نشده است.
استفاده
نصب اولیه
برنامه های کاربردی باید مقداردهی اولیه Colorama با استفاده از:
از colorama واردات init انجام
init انجام ()
اگر شما بر روی ویندوز، از تماس به '' init انجام () 'هستند شروع خواهد شد فیلتر توالی فرار ANSI از هر گونه متن ارسال شده به STDOUT یا stderr، و آنها را جایگزین معادل با فراخوانی win32.
تلفن '' init انجام () '' تاثیری در سیستم عامل های دیگر (مگر اینکه شما با استفاده از 'autoreset، پایین را ببینید) قصد این است که تمام برنامه های کاربردی باید init انجام (تماس بگیرید) بدون قید و شرط، و سپس خروجی متن رنگی خود را به سادگی بر روی تمام سیستم عامل کار می کند.
خروجی های رنگی
کراس پلت فرم چاپ متن رنگی و سپس می تواند انجام شود:
از 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 واردات init انجام
init انجام ()
# سپس با استفاده از Termcolor برای همه خروجی متن رنگی
از termcolor واردات رنگی
چاپ رنگی ('سلام جهان!'، 'سبز'، 'on_red')
ثابت قالب بندی در دسترس هستند:
فور: BLACK، قرمز، سبز، زرد، آبی، بنفش، فیروزه ای، سفید، DEFAULT.
بازگشت: BLACK، قرمز، سبز، زرد، آبی، بنفش، فیروزه ای، سفید، DEFAULT.
سبک: DIM، عادی، روشن، RESET_ALL
Style.RESET_ALL بازنشانی پیش زمینه، پس زمینه و روشنایی. Colorama این تنظیم مجدد به صورت خودکار در هنگام خروج از برنامه انجام (اجرا نشده).
Autoreset
اجرا نشده
اگر شما خودتان را بارها و بارها ارسال توالی تنظیم مجدد به خاموش کردن تغییر رنگ در پایان هر چاپ، سپس init انجام (autoreset = واقعی) خواهد به طور خودکار که:
از colorama واردات init انجام
init انجام (autoreset = واقعی)
چاپ Fore.RED + 'برخی از متن قرمز'
چاپ 'به طور خودکار به رنگ پیش فرض دوباره'
بدون بسته بندی STDOUT
Colorama کار می کند با بسته بندی STDOUT و stderr با اشیاء پروکسی، که نوشتن باطل () به کار خود را. با استفاده از init انجام (autoreset = واقعی) این کاغذ بسته بندی را انجام خواهد داد در تمام سیستم عامل، نه فقط ویندوز.
اگر این اشیاء پروکسی بسته بندی STDOUT و stderr علت مشکل دارید، و سپس این را می توان با استفاده از init انجام (بسته بندی = FALSE) (اجرا نشده) غیر فعال، و شما می توانید از پروکسی به جای AnsiToWin32 Colorama به طور مستقیم دسترسی داشته باشید. هر گونه دسترسی صفت در این شی خواهد شد به جریان آن کاری ادامه داده اند، جدا از .write ()، که بر روی ویندوز است لغو شده به اولین انجام ANSI به Win32 را تبدیل در متن ارسال:
از colorama واردات init انجام، AnsiToWin32
init انجام (بسته بندی = FALSE)
جریان = AnsiToWin32 (sys.stderr)
چاپ >> جریان، 'متن آبی در stderr' Fore.BLUE +
توسعه
تست نیاز به ماژول مسخره مایکل Foord است. من شده اند با استفاده nosetests برای اجرای آزمون اگر چه ممکن است بدون آن کار می کنند، با استفاده از:
colorama.tests متر پایتون <ماژول>
در چه در این نسخه جدید است.
در برخی از اسناد را برای موقعیت مکان نما و صفحه نمایش روشن به README اضافه شده. اضافه کردن 'راه اندازی مجدد کنتور و توابع' 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 در حال حاضر به رنگ برگرداندن آنها به عنوان زمانی که init انجام () نامیده می شد بود. برخی از درس امیدوارم مورد آزمایش قبل از عرضه آموخته است.
به چه چیزی جدید در نسخه 0.1.13 است:
در نسخه قبلی به طور کامل شکسته شد (حاوی هیچ منبع). اوه دو برابر شود.
به چه جدید در نسخه 0.1.10 است:
به توقف تقلید متن روشن با پیشینه روشن است. "طبیعی" نمایش متن با استفاده از پیش زمینه های Win32 نرمال به جای روشن است. رها کردن پشتیبانی از متن "کم".
به چه جدید در نسخه 0.1.9 است:
در رفع ناسازگاری با پایتون 2.5 و قبل از آن حذف وابستگی setup.py در setuptools، در حال حاضر با استفاده از distutils stdlib
در مورد نیاز:
پایتون
نظر یافت نشد