colorama

Colorama gir en enkel kryssplattform API for å skrive ut farget terminal tekst fra Python-programmer.
ANSI escape tegnsekvenser blir ofte brukt til å produsere farget terminal teksten på Mac og Unix. Colorama gir noen snarveier for å generere disse sekvensene, og gjør dem fungere på Windows også.
Dette har den lykkelige bivirkning at eksisterende programmer eller biblioteker som allerede bruker ANSI sekvenser å produsere farget utgang på Linux eller Mac (f.eks. Ved bruk av pakker som 'termcolor') kan nå også fungere på Windows, ganske enkelt ved å importere og initialisering Colorama.
Status
Under utvikling. Enkelte funksjoner, som nevnt nedenfor, er ikke implementert ennå.
Bruk
Initialisering
Søknader skal initial Colorama hjelp:
fra Colorama import init
init ()
Hvis du er på Windows, kallet til '' init () '' vil starte filtrering ANSI escape-sekvenser ut av enhver tekst sendt til stdout eller stderr, og vil erstatte dem med tilsvarende Win32 samtaler.
Calling '' init () '' har ingen effekt på andre plattformer (med mindre du bruker 'autoresett', se nedenfor) Intensjonen er at alle søknader skal kalle init () ubetinget, da deres farget tekst utgang fungerer bare på alle plattformer.
Farget Output
Cross-plattform utskrift av farget tekst kan da gjøres:
fra Colorama import Fore, Back, Stil
print Fore.RED + "noen røde teksten '
print Back.GREEN + og med en grønn bakgrunn '
print Style.DIM + "og i dim teksten"
print + Fore.DEFAULT + Back.DEFAULT + Style.DEFAULT
print "tilbake til normal nå '
eller rett og slett ved å manuelt skrive ut ANSI sekvenser fra din egen kode:
print '/ 033 [31m' + 'noen rød tekst'
print '/ 033 [30m' # og reset til default farge
eller Colorama kan benyttes gjerne i forbindelse med eksisterende ANSI-biblioteker som Termcolor (http://pypi.python.org/pypi/termcolor):
# Bruk Colorama å gjøre Termcolor arbeid på Windows også
fra Colorama import init
init ()
# Deretter bruke Termcolor for all farget tekst utgang
fra termcolor import farget
skrive ut farget ("Hello, World! ',' grønn ',' on_red ')
Tilgjengelige formaterings konstanter er:
Fore: svart, rød, grønn, gul, blå, magenta, cyan, WHITE, STANDARD.
Tilbake: svart, rød, grønn, gul, blå, magenta, cyan, WHITE, STANDARD.
Stil: DIM, NORMAL, lyse, RESET_ALL
Style.RESET_ALL tilbake forgrunn, bakgrunn og lysstyrke. Colorama vil utføre denne reset automatisk på programmet exit (Ikke implementert).
Autoresett
Ikke implementert
Hvis du finner deg selv gjentatte ganger å sende reset sekvenser for å slå av fargeendringer på slutten av hver print, så init (autoresett = True) vil automatisere at:
fra Colorama import init
init (autoresett = True)
print Fore.RED + "noen røde teksten '
print 'automatisk tilbake til standardfargen igjen'
Uten innpakning stdout
Colorama fungerer ved å pakke stdout og stderr med proxy-objekter, som overstyrer write () for å gjøre arbeidet sitt. Bruke init (autoresett = True) vil gjøre dette bryting på alle plattformer, ikke bare Windows.
Hvis disse proxy gjenstander innpakning stdout og stderr føre til at du problemer, så dette kan deaktiveres ved hjelp av init (wrap = False) (Ikke implementert), og du kan i stedet få tilgang Colorama største AnsiToWin32 proxy direkte. Enhver attributt tilgang på dette objektet vil bli videresendt til bekken den legger seg, bortsett fra -write (), som på Windows overstyres til første utføre ANSI til Win32 konvertering på tekst:
fra Colorama import init, AnsiToWin32
init (wrap = False)
stream = AnsiToWin32 (sys.stderr)
print >> stream, Fore.BLUE + 'blå tekst på stderr'
Utvikling
Tester krever Michael Foord sin Mock modul. Jeg har brukt nosetests å kjøre testene selv om de kan fungere uten det, ved hjelp av:
python -m colorama.tests

Hva er nytt i denne utgaven:.

• Lagt noen dokumentasjon for markøren posisjonering og klar skjerm til README. Legg 'reinit' og 'deinit' funksjoner, som foreslått av Charles FOL og Romanov DA.

Hva er nytt i versjon 0.1.18:

• Fix README (ingen slik attr som Fore.DEFAULT , etc), vennligst rapportert av nodakai.

Hva er nytt i versjon 0.1.17:

• Unngå utskrift av søppel ANSI-koder ved å installere med pip

Hva er nytt i versjon 0.1.16:

• Re-upload å fikse tidligere feil. Gjør rent nå fjerner gammel MANIFEST.

Hva er nytt i versjon 0.1.15:

• Fix python3 inkompatibilitet ber rapportert av Gunter Koloušek

Hva er nytt i versjon 0.1.14:

• Fix hardkodet reset til hvit-on- svarte farger. Fore.RESET, Back.RESET og Style.RESET_ALL nå gå tilbake til fargene som de var da init () ble kalt. Noen erfaringer forhåpentligvis lært om testing før utgivelse.

Hva er nytt i versjon 0.1.13:

• Forrige versjon var helt knust (inneholdt ingen kilde) . Double oops.

Hva er nytt i versjon 0.1.10:

• Stopp emulere 'lys' tekst med lyse bakgrunner. Skjerm 'normal' tekst med win32 normal forgrunnen i stedet for lyse. Slipp-støtte for 'dim "tekst.

Hva er nytt i versjon 0.1.9:

• Fix inkompatibilitet med Python 2.5 og tidligere Fjern oppsett. py avhengigheten setuptools, nå bruker stdlib distutils

Krav

• Python