Colorama обеспечивает простой кросс-платформенный API, чтобы напечатать цветной терминал текст из приложений Python.
ANSI последовательности побег символов обычно используются для создания цветного терминала текст на Маках и Unix. Colorama предоставляет некоторые ярлыки для создания этих последовательностей, и заставляет их работать на Windows, тоже.
Это счастливое побочный эффект, что существующие приложения или библиотеки, которые уже используют последовательности ANSI для производства цветной вывод на Linux или компьютеров Mac (например. С помощью пакетов, как "termcolor ') теперь можно также работать на Windows, просто импорта и инициализации Colorama.
Статус
В развитие. Некоторые особенности, как указано ниже, еще не реализованы.
Использование
Инициализация
Приложения должны инициализировать Colorama с помощью:
от Colorama инициализации импорта
в этом()
Если вы находитесь на Windows, призыв к "" Init () '' начнет фильтрации ANSI управляющие последовательности из любого текста отправляется на стандартный вывод или поток ошибок, и заменить их эквивалент Win32 вызовов.
Вызов '' Init () '' не имеет никакого эффекта на других платформах (если вы не используете 'автоматического возврата ", смотри ниже) Предполагается, что все приложения должны вызывать Init (), безусловно, то их цвета вывода текста просто работает на всех платформах.
Цветные Выход
Кросс-платформенная печати цветного текста может быть сделано:
от Colorama Фор импорта, назад, Style
печать 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 импорта цветной
печатать цветные ('Hello, World! "," зеленый "," on_red')
Доступные константы форматирования являются:
Передние: черный, красный, зеленый, желтый, синий, пурпурный, голубой, белый, по умолчанию.
Вернуться: черный, красный, зеленый, желтый, синий, пурпурный, голубой, белый, по умолчанию.
Стиль: DIM, Норма, Светлее, RESET_ALL
Style.RESET_ALL сбрасывает переднего плана, фона и яркость. Colorama будет выполнять эту сброс автоматически при выходе из программы (не реализован).
Автоперезапуска
Не реализована
Если вы окажетесь неоднократно отправки сброса последовательности, чтобы выключить изменения цвета в конце каждого печать, затем инициализации (Автосброс = True) позволит автоматизировать, что:
от Colorama инициализации импорта
инициализации (Автосброс = True)
печать Fore.RED + красный текст "
Печать «автоматически вернуться к цвету по умолчанию снова"
Без упаковки STDOUT
Colorama работает, обернув STDOUT и STDERR с прокси-объектов, которые переопределяют записи (), чтобы сделать свою работу. Использование инициализации (автовозврата = True) будет делать это обертывание на всех платформах, а не только Windows.
Если эти прокси-объекты упаковка стандартный вывод и стандартный вывод причинить вам проблемы, то это может быть отключена с помощью инициализации (обертывание = False) (Не реализовано), и вы можете получить доступ к AnsiToWin32 вместо прокси Colorama непосредственно. Любой доступ атрибут этого объекта будет направлен поток это оборачивается, помимо .WRITE (), которая на Windows, отменяется сначала выполнить ANSI для Win32 преобразование текста на:
от Colorama инициализации импорта, AnsiToWin32
инициализации (обертывание = False)
поток = AnsiToWin32 (sys.stderr)
для печати >> поток, 'синий текст на стандартный вывод ошибок "Fore.BLUE +
Разработка
Тесты требуют пробный модуль Майкла Фурд в. Я использую nosetests для запуска тестов, хотя они могут работать и без него, с помощью:
питон -m colorama.tests <модуль>
Что нового В этом выпуске:.
- Добавлена некоторую документацию для позиционирования курсора и ясно, экран README. Добавить «Reinit 'и' 'Deinit функции, как это было предложено Карлом ВОЛС и Романов Д.А..
Что нового в версии 0.1.18:
- Исправлена README (нет такого, как атр Fore.DEFAULT и т.д.), любезно сообщил nodakai.
Что нового в версии 0.1.17:
- Запрет печати кодов ANSI мусора при установке с пип
Что нового в версии 0.1.16:
- Re-загрузки, чтобы исправить предыдущие ошибки. Сделать чистой теперь снимает старый манифесте.
Что нового в версии 0.1.15:
- Исправлена несовместимость python3 любезно сообщил Гюнтер Koloušek
Что нового в версии 0.1.14:
- Fix трудно закодированный сброс белый-на- черные цвета. Fore.RESET, Back.RESET и Style.RESET_ALL Теперь вернуться к цветам, как они были, когда инициализации () была вызвана. Некоторые уроки мы надеемся, узнал о тестировании перед выпуском.
Что нового в версии 0.1.13:
- Предыдущая версия была полностью разрушена (не содержит источник) , Двухместный ой.
Что нового в версии 0.1.10:
- Остановить эмуляции '' яркий текст с ярким фоном. Дисплей "нормальный" текст, используя win32 нормальный передний план вместо ярко. Бросьте поддержку "тусклом 'текста.
Что нового в версии 0.1.9:
- Fix несовместимость с Python 2.5 и выше Удалить настройки. ру зависимость от Setuptools, теперь использует STDLIB Distutils
Требования
- Python
Комментарии не найдены