colorama

colorama een eenvoudige cross-platform API om gekleurde terminal tekst uit Python-toepassingen af ​​te drukken.
ANSI escape-teken reeksen worden vaak gebruikt om gekleurde terminal tekst op Macs en Unix te produceren. Colorama biedt een aantal snelkoppelingen naar deze sequenties te genereren, en maakt ze werken op Windows ook.
Dit heeft de gelukkige neveneffect dat de bestaande toepassingen of bibliotheken die al gebruik maken van ANSI sequenties om gekleurde uitgang op Linux of Mac te produceren (bijv. Het gebruik van pakketten zoals 'termcolor') kan nu ook werken op Windows, simpelweg door het importeren en initialiseren Colorama.
Status
In ontwikkeling. Sommige functies, zoals hieronder vermeld, zijn nog niet geïmplementeerd.
Gebruik
Initialisatie
Aanvragen moeten initialiseren Colorama met:
van colorama import init
in het ()
Als je op Windows, de oproep om '' init () '' zal beginnen te filteren ANSI escape sequences uit van een tekst naar stdout of stderr, en zal ze te vervangen door gelijkwaardige Win32 noemt.
Calling '' init () '' heeft geen effect op andere platformen (tenzij je 'autoreset' gebruiken, zie hieronder) Het is de bedoeling dat alle toepassingen init (moet bellen) onvoorwaardelijk, dan is hun gekleurde tekst uitgang gewoon werkt op alle platformen.
Gekleurde Output
Cross-platform afdrukken van gekleurde tekst kan dan worden gedaan:
van colorama import Fore, Back, Style
afdrukken Fore.RED + 'enkele rode tekst'
afdrukken Back.GREEN + en met een groene achtergrond '
afdrukken Style.DIM + 'en in dim tekst'
print + Fore.DEFAULT + Back.DEFAULT + Style.DEFAULT
print 'terug naar normaal bedrijf'
of gewoon door met de hand te drukken ANSI sequenties uit uw eigen code:
print '/ 033 [31m' + 'enkele rode tekst'
print '/ 033 [30m' # en teruggezet naar kleur default
of Colorama kan gelukkig worden gebruikt in combinatie met bestaande ANSI bibliotheken zoals Termcolor (http://pypi.python.org/pypi/termcolor):
# Gebruiken Colorama om Termcolor werken op Windows te maken
van colorama import init
in het ()
# Gebruik dan Termcolor voor alle gekleurde tekst uitgang
van termcolor import gekleurde
afdrukken gekleurde ('Hello, World!', 'groen', 'on_red')
Beschikbare opmaak constanten zijn:
Fore: zwart, rood, groen, geel, blauw, magenta, cyaan, WHITE, STANDAARD.
Back: zwart, rood, groen, geel, blauw, magenta, cyaan, WHITE, STANDAARD.
Stijl: DIM, NORMAAL, HELDER, RESET_ALL
Style.RESET_ALL reset voorgrond, achtergrond en helderheid. Colorama zal deze reset automatisch uit te voeren op programma afslag (Niet geïmplementeerd).
Autoreset
Niet geïmplementeerd
Als je merkt dat je herhaaldelijk versturen reset sequenties kleurveranderingen aan het eind van elke print uit te schakelen, dan init (Autoreset = True) zal automatiseren dat:
van colorama import init
init (Autoreset = True)
afdrukken Fore.RED + 'enkele rode tekst'
print 'automatisch terug naar standaard kleur weer'
Zonder verpakking stdout
Colorama werkt door wikkelen stdout en stderr met proxy objecten, die override write () om hun werk te doen. Met behulp van init (Autoreset = True), zal deze verpakking te doen op alle platforms, niet alleen Windows.
Als deze proxy objecten wikkelen stdout en stderr want je problemen, dan kan dit worden uitgeschakeld met init (wrap = Vals) (Niet geïmplementeerd), en u kunt in plaats daarvan toegang Colorama's AnsiToWin32 proxy direct. Elke attribuut toegang op dit object zal worden doorgestuurd naar de beek te wraps, afgezien van .write (), die op Windows is overschreven om eerst presteren de ANSI naar Win32 conversie op tekst:
van colorama import init, AnsiToWin32
init (wrap = Vals)
stroom = AnsiToWin32 (sys.stderr)
afdrukken >> stroom, Fore.BLUE + 'blauwe tekst op stderr'
Ontwikkeling
Tests vereisen Mock module Michael Foord's. Ik gebruik nosetests aan de tests uit te voeren, hoewel ze kunnen werken zonder het, met behulp van:
python -m colorama.tests

Wat is nieuw in deze release:.

• Toegevoegd wat documentatie voor cursor positionering en heldere scherm om readme. Voeg 'reinit' en functies 'deinit', zoals voorgesteld door Charles FOL en Romanov DA.

Wat is nieuw in versie 0.1.18:

• Fix README (geen dergelijke attr als Fore.DEFAULT , etc), vriendelijk gemeld door nodakai.

Wat is nieuw in versie 0.1.17:

• Voorkom afdrukken van garbage ANSI codes na het installeren met pip

Wat is nieuw in versie 0.1.16:

• Re-upload naar de vorige fout te herstellen. Maak schoon verwijdert nu oud MANIFEST.

Wat is nieuw in versie 0.1.15:

• Fix python3 onverenigbaarheid vriendelijk gemeld door Gunter Koloušek

Wat is nieuw in versie 0.1.14:

• Fix hard-coded reset naar wit-op- zwarte kleuren. Fore.RESET, Back.RESET en Style.RESET_ALL nu terugkeren naar de kleuren zoals ze waren toen init () werd genoemd. Sommige lessen hopelijk geleerd over het testen voorafgaand aan de release.

Wat is nieuw in versie 0.1.13:

• Vorige versie werd volledig kapot (bevatte geen bron) . Dubbele oops.

Wat is nieuw in versie 0.1.10:

• Stoppen emuleren van 'lichte' tekst met een heldere achtergrond. Display 'normale' tekst met behulp van win32 normale voorgrond in plaats van licht. Drop ondersteuning voor 'dim' tekst.

Wat is nieuw in versie 0.1.9:

• Fix onverenigbaarheid met Python 2.5 en eerdere verwijderen setup. py afhankelijkheid setuptools, gebruikt nu stdlib distutils

Eisen

• Python