colorama

Colorama осигурява прост кръст-платформа API, за да отпечатате цветни терминал текст от Python приложения.
ANSI бягство последователности от символи които обикновено се използват за производството на оцветено терминал текст на Mac-ове и Unix. Colorama предоставя някои комбинации, за да се генерират тези последователности, и ги кара да работят на Windows също.
Това има щастлив страничен ефект, че съществуващите приложения или библиотеки, които вече използват ANSI последователности, за да произвеждат цветна продукция на Linux или Mac-ове (напр. Използване на пакети като "termcolor") вече може да работи и на Windows, просто като вносител и инициализиране Colorama.
<Силен> Status
В процес на разработка. Някои функции, както е отбелязано по-долу, не се изпълняват, все още.
<Силен> Usage
Инициализация
Заявленията трябва да се инициализира Colorama с помощта на:
от Colorama внос първоначален
в него ()
Ако сте на Windows, призива за '' първоначален () '' ще започне филтрирането ANSI екраниращи последователности от всеки текст, изпратен на стандартния изход или STDERR, и ще ги замени с равностоен Win32 призовава.
Повикване '' първоначален () '' не оказва влияние върху други платформи (освен ако не използвате "автоматично нулиране", виж по-долу) Намерението е, че всички заявления трябва първоначален (разговор) безусловно, а след това им цветна продукция текст просто работи на всички платформи.
Цветни Output
Cross-платформа печат на цветен текст след това може да се направи:
от Colorama внос Фор, Back, Style
принт Fore.RED + "някои червен текст"
печатащите Back.GREEN + и със зелен фон "
принт Style.DIM + "и в мъждивата текст"
принт + Fore.DEFAULT + Back.DEFAULT + Style.DEFAULT
принт "върне към нормалното сега"
или просто чрез ръчно отпечатване ANSI последователности от вашия собствен код:
принт "/ 033 [31 m '+' някои червен текст"
принт "/ 033 [тридесет м" # и възстановяват стандартните цвят
или Colorama може да се използва щастливо във връзка със съществуващите библиотеки ANSI като Termcolor (http://pypi.python.org/pypi/termcolor):
# Използвайте Colorama да Termcolor работата по Windows твърде
от Colorama внос първоначален
в него ()
# След това използвайте Termcolor за всички цветна продукция текст
от termcolor оцветен внос
отпечатате цветни ("Hello, World!", "зелен", "on_red")
Налични константи форматиране са:
Фор: черен, червен, зелен, жълт, син, магента, циан, WHITE, DEFAULT.
Обратно: черен, червен, зелен, жълт, син, магента, циан, WHITE, DEFAULT.
Стил: DIM, NORMAL, светъл, RESET_ALL
Style.RESET_ALL нулира преден план, фон и яркост. Colorama ще извърши това нулиране автоматично на програма за излизане (Не е изпълнено).
Автоматично нулиране
Не е изпълнено
Ако откриете себе си многократно изпращане нулират последователности, за да изключите промени в цвета в края на всяка разпечатка, след първоначален (автоматично нулиране = True) ще автоматизира, че:
от Colorama внос първоначален
първоначален (автоматично нулиране = True)
принт Fore.RED + "някои червен текст"
принт "автоматично обратно в цвят по подразбиране отново"
Без амбалажна стандартния изход
Colorama работи чрез обвиване стандартния изход и STDERR с прокси обекти, които да заместват записване (), за да си вършат работата. Използването първоначален (автоматично нулиране = True) ще направи това опаковане на всички платформи, а не само Windows.
Ако тези прокси обекти опаковка на стандартния изход и STDERR защото ти проблеми, а след това може да бъде изключено посредством първоначален (разгънатата = False) (не е приложена), и вместо това можете да получите достъп AnsiToWin32 прокси Colorama директно. Всеки достъп атрибут на този обект ще бъде препратен към потока го увива, освен .write (), който на Windows е засегнато първо да се извърши преобразуване на ANSI за Win32 по текст:
от Colorama внос първоначален, AnsiToWin32
първоначален (разгънатата = False)
поток = AnsiToWin32 (sys.stderr)
принт >> поток, Fore.BLUE + "син текст на STDERR"
<Силен> развитие
Тестовете изискват Mock модул Michael Foord е. Имам Използвам nosetests да изпълнете тестовете, въпреки че те могат да работят без него, с помощта на:
питон -m colorama.tests <модул>

Какво ново в тази версия:.

• добавили някои документация за позициониране на курсора и ясен екран, за да Readme. Добави "REINIT" и функции "deinit", както е предложено от Charles FOL и Романов DA.

Какво ново във версия 0.1.18:

• Fix README (няма такова ATTR като Fore.DEFAULT и т.н.), любезно съобщава от nodakai.

Какво ново във версия 0.1.17:

• Prevent печат боклук ANSI кодове при инсталиране със семки

Какво ново във версия 0.1.16:

• качите отново да се определи предишната грешка. Направете чиста сега премахва старата покажат.

Какво ново във версия 0.1.15:

• Fix python3 несъвместимост любезно съобщава от Гюнтер Kolousek

Какво ново във версия 0.1.14:

• Fix трудно кодирани възстановена до бяло-on- черни цветове. Fore.RESET, Back.RESET и Style.RESET_ALL сега се върне към цветовете, тъй като те са били, когато първоначален () се нарича. Някои уроци надяваме научиха за проверка преди да се освободи.

Какво ново във версия 0.1.13:

• предишната версия е напълно разбити (не съдържа източник) , Двойна Опа.

Какво ново във версия 0.1.10:

• Спри подражават "светло" текст с ярки фонове. Display "нормално" текст с помощта на win32 нормално преден план вместо ярка. Капка подкрепа за "слаба" текст.

Какво ново във версия 0.1.9:

• Fix несъвместимост с Python 2.5 и по-рано Махни настройка. Ру зависимостта от setuptools, сега използва stdlib distutils

<силни> Изисквания

• Python