colorama

COLORAMA poskytuje jednoduché cross-platform API pro tisk barevný terminálu textu z aplikací Python.
ANSI escape znak sekvence jsou běžně používány k výrobě barevného terminálu text na Mac a Unix. Colorama poskytuje některé klávesové zkratky k výrobě těchto sekvencí, a dělá jim pracovat na Windows taky.
To má šťastný vedlejší účinek, že existující aplikace nebo knihovny, které již používají ANSI sekvence pro výrobu barevné výstup na Linux nebo Mac (např. Pomocí balíčků, jako "termcolor"), mohou nyní také pracovat na Windows, jednoduše tím, že dovoz a inicializace Colorama.
Status
Ve vývoji. Některé funkce, jak je uvedeno níže, jsou zatím není implementován.
Použití
Inicializace
Žádosti by se inicializovat Colorama pomocí:
od COLORAMA import init
v tom ()
Pokud jste na Windows, volání "" init () '' začne filtrování sekvence ANSI escape z jakéhokoli textu zaslaném stdout nebo stderr, a nahradí je s ekvivalentem Win32 volání.
Volání '' init () "" nemá žádný vliv na jiných platformách (pokud nepoužíváte "Autoreset", viz níže) Záměrem je, že všechny aplikace by měly init (Call) bezpodmínečně, pak jejich barevné textový výstup jednoduše funguje na všech platformách.
Barevný výstup
Cross-platform tisk barevný text pak může být provedena:
od COLORAMA dovozu Fore, Back, Style
print Fore.RED + "některé červený text"
tisk Back.GREEN + a se zeleným pozadím "
print Style.DIM + "a při slabém textu"
print + Fore.DEFAULT + Back.DEFAULT + Style.DEFAULT
print 'zpět do normálu se podnikem'
nebo jednoduše ručně tiskem ANSI sekvence z vašeho vlastního kódu:
print "/ 033 [31 m '+' nějaký červený text"
print "/ 033 [30 m '# a obnovit na výchozí barvu
nebo Colorama mohou být použity ve spojení s šťastně stávajícími ANSI knihoven, jako jsou Termcolor (http://pypi.python.org/pypi/termcolor):
# Použít Colorama aby Termcolor práci na systému Windows příliš
od COLORAMA import init
v tom ()
# Pak použít Termcolor pro všechny barevné textový výstup
od termcolor import barevné
tisknout barevné ("Hello, World!", "zelený", "on_red")
Dostupné formátování konstanty jsou:
Fore: černá, červená, zelená, žlutá, modrá, purpurová, azurová WHITE, DEFAULT.
Back: černá, červená, zelená, žlutá, modrá, purpurová, azurová WHITE, DEFAULT.
Styl: DIM, Normální, Jasný, RESET_ALL
Style.RESET_ALL resetuje popředí, pozadí a jas. Colorama vystoupí tento restart automaticky při ukončení programu (Není implementováno).
Autoreset
Není implementováno
Pokud zjistíte sami opakovaně posílá resetovat sekvence vypnout barevné změny na konci každého tisku, pak init (automatický reset = true), bude automatizovat, že:
od COLORAMA import init
init (Autoreset = True)
print Fore.RED + "některé červený text"
print 'automaticky zpět do výchozí barvu znovu "
Bez balení stdout
Colorama funguje tak, že balení stdout a stderr se proxy objektů, která přehlíží write (), aby dělat svou práci. Použití init (AUTORESET = TRUE) bude dělat tento obal na všech platformách, ne jen Windows.
Pokud tyto objekty proxy serveru balicí stdout a stderr způsobit problémy, pak to může být zakázáno pomocí init (zábal = false) (není implementována), a místo toho můžete přistupovat COLORAMA je AnsiToWin32 proxy serveru přímo. Jakýkoliv přístup atribut u tohoto objektu budou předány do proudu to zábaly, na rozdíl od .write (), která na Windows je přepsána nejprve provést ANSI na Win32 konverzi na textu:
od COLORAMA importu init, AnsiToWin32
init (wrap = False)
proud = AnsiToWin32 (sys.stderr)
vytisknout >> potok, Fore.BLUE + 'modrý text na stderr "
Development
Zkoušky vyžadují Mock modul Michaela Foord je. Byl jsem pomocí nosetests spouštět testy, ačkoli oni mohou pracovat bez něj, použití:
python -m colorama.tests

Co je nového v této verzi:.

• Přidána nějakou dokumentaci k polohování kurzoru a jasné obrazovky Readme. Přidat 'reinic "a" deinit "funkce, jak navrhl Charles FOL a Romanov DA.

Co je nového ve verzi 0.1.18:

• Fix README (žádná taková attr jako Fore.DEFAULT , atd), laskavě hlásí nodakai.

Co je nového ve verzi 0.1.17:

• Zabránit tisk odpadků ANSI kódů při instalaci s pip

Co je nového ve verzi 0.1.16:

• znovu nahrát opravit předchozí chyby. Proveďte čisté nyní odstraňuje stará MANIFEST.

Co je nového ve verzi 0.1.15:

• Fix python3 neslučitelnost laskavě hlášeny Gunter Koloušek

Co je nového ve verzi 0.1.14:

• Fix pevně resetu na bílo-on- černé barvy. Fore.RESET, Back.RESET a Style.RESET_ALL teď vrátit k barvám, jako oni byli, když init () byla volána. Některé lekce doufejme, že se dozvěděl o testování před propuštěním.

Co je nového ve verzi 0.1.13:

• Předchozí verze byla zcela rozbité (neobsahovalo žádný zdroj) , Double oops.

Co je nového ve verzi 0.1.10:

• Zastavit emuluje "jasný" text s jasným pozadím. Zobrazí "normální" textu pomocí win32 normální popředí namísto jasné. Drop podpora pro "slabém" textu.

Co je nového ve verzi 0.1.9:

• Fix nekompatibilitu s Python 2.5 a starší Odstranit nastavení. py závislost na setuptools, nyní používá stdlib distutils

Požadavky na :

• Python