colorama

Colorama giver en enkel cross-platform API til at udskrive farvet terminal tekst fra Python applikationer.
ANSI escape tegnsekvenser er almindeligt anvendt til at producere farvet terminal tekst på Mac-computere og Unix. Colorama giver nogle genveje til at generere disse sekvenser, og gør dem arbejde på Windows også.
Dette har den lykkelige bivirkning, at eksisterende programmer eller biblioteker, som allerede bruger ANSI-sekvenser til at producere farvet output på Linux eller Mac (fx. Ved hjælp af pakker som 'termcolor ") kan nu også arbejde på Windows, blot ved at importere og initialisering Colorama.
Status
I udvikling. Nogle funktioner, som anført nedenfor, er ikke implementeret endnu.
Anvendelse
Initialisering
Ansøgninger skal initialisere Colorama hjælp:
fra Colorama import init
init ()
Hvis du er på Windows, opfordringen til at '' init () '' vil begynde filtrering ANSI escape-sekvenser ud af en tekst sendes til stdout eller stderr, og vil erstatte dem med tilsvarende Win32 opkald.
Opkald '' init () '' har ingen virkning på andre platforme (medmindre du bruger "autoreset", se nedenfor) Det er hensigten, at alle ansøgninger skal ringe init () betingelsesløst, så deres farvede tekst output fungerer simpelthen på alle platforme.
Farvet Output
Cross-platform trykning af farvet tekst kan derefter gøres:
fra Colorama import Fore, Tilbage, Style
print Fore.RED + 'nogle rød tekst'
print Back.GREEN + og med en grøn baggrund '
print Style.DIM + 'og i dim tekst'
print + Fore.DEFAULT + Back.DEFAULT + Style.DEFAULT
print "tilbage til normal nu '
eller simpelthen ved manuelt at udskrive ANSI-sekvenser fra din egen kode:
print '/ 033 [31m' + 'nogle rød tekst'
print '/ 033 [30m' # og nulstillet til standard farve
eller Colorama kan bruges lykkeligt sammen med eksisterende ANSI-biblioteker såsom Termcolor (http://pypi.python.org/pypi/termcolor):
# Bruge Colorama til at gøre Termcolor arbejde på Windows også
fra Colorama import init
init ()
# Derefter bruge Termcolor for alle farvet tekst output
fra termcolor import farvet
udskrive farvet ('Hello, World!', 'grøn', 'on_red')
Ledige formatering konstanter er:
Fore: sort, rød, grøn, gul, blå, magenta, cyan, WHITE, DEFAULT.
Tilbage: sort, rød, grøn, gul, blå, magenta, cyan, WHITE, DEFAULT.
Stil: DIM, NORMAL, LYS, RESET_ALL
Style.RESET_ALL nulstiller forgrund, baggrund og lysstyrke. Colorama vil udføre denne reset automatisk på programmet exit (Ikke implementeret).
Autoreset
Ikke implementeret
Hvis du finde dig selv gentagne gange at sende reset sekvenser for at slukke farveændringer i slutningen af ​​hvert print, så init (Autoreset = True) vil automatisere, at:
fra Colorama import init
init (Autoreset = True)
print Fore.RED + 'nogle rød tekst'
print "automatisk tilbage til standard farve igen '
Uden indpakning stdout
Colorama virker ved indpakning stdout og stderr med proxy objekter, at overstyring skrive () til at gøre deres arbejde. Brug af init (Autoreset = True) vil gøre dette indpakning på alle platforme, ikke kun Windows.
Hvis disse proxy objekter indpakning stdout og stderr årsag dig problemer, så dette kan deaktiveres ved hjælp af init (wrap = False) (Ikke implementeret), og du kan i stedet få adgang Colorama s AnsiToWin32 proxy direkte. Enhver attribut adgang på dette objekt vil blive sendt til åen det ombrydes, bortset fra .write (), som på Windows tilsidesættes først udføre ANSI til Win32 konvertering på tekst:
fra Colorama import init, AnsiToWin32
init (wrap = False)
stream = AnsiToWin32 (sys.stderr)
print >> strøm, Fore.BLUE + 'blå tekst på stderr'
Udvikling
Tests kræver Michael foord s Mock modul. Jeg har brugt nosetests at køre testene, selv om de kan arbejde uden det, ved hjælp:
python -m colorama.tests

Hvad er nyt i denne udgivelse:.

• Tilføjet noget dokumentation for cursor positionering og klar skærm til Vigtigt. Tilføj "reinit" og "deinit" funktioner, som foreslået af Charles FOL og Romanov DA.

Hvad er nyt i version 0.1.18:

• Fix README (ikke sådan attr som Fore.DEFAULT osv), venligt rapporteret af nodakai.

Hvad er nyt i version 0.1.17:

• Undgå trykning af skrald ANSI-koder ved installation med pip

Hvad er nyt i version 0.1.16:

• Re-upload til at fastsætte tidligere fejl. Foretag ren fjerner nu gamle AABENBAR.

Hvad er nyt i version 0.1.15:

• Fix python3 uforenelighed venligt rapporteret af Gunter Koloušek

Hvad er nyt i version 0.1.14:

• Fix hårdt kodet nulstilling til hvid-on- sorte farver. Fore.RESET, Back.RESET og Style.RESET_ALL nu vende tilbage til farverne, som de var, da init () blev kaldt. Nogle erfaringer forhåbentlig lært om at teste før frigivelse.

Hvad er nyt i version 0.1.13:

• Forrige version blev fuldstændig brudt (indeholdt ingen kilde) . Dobbelt oops.

Hvad er nyt i version 0.1.10:

• Stop efterligne "lyse" tekst med lyse baggrunde. Display 'normale' tekst ved hjælp win32 normal forgrunden i stedet for lyse. Drop støtte til 'dim' tekst.

Hvad er nyt i version 0.1.9:

• Fix uforenelighed med Python 2.5 og tidligere Fjern setup. py afhængighed setuptools, bruger nu stdlib distutils

Krav :

• Python