colorama

Colorama bied 'n eenvoudige kruis-platform API gekleurde terminale teks van Python aansoeke te druk.
ANSI ontsnapping karakter rye word algemeen gebruik om gekleurde terminale teks Macs en Unix te produseer. Colorama bied 'n paar kortpaaie om hierdie reekse te genereer en maak hulle werk op Windows ook.
Dit het die gelukkige newe-effek dat bestaande programme of biblioteke wat reeds gebruik ANSI rye gekleurde afvoer op Linux of Mac te produseer (bv. Die gebruik van pakkette soos 'termcolor') kan nou ook werk op Windows, net deur die invoer en inisialisering Colorama.
Status
In ontwikkeling. Sommige funksies, soos hieronder aangedui, is nog nie geïmplementeer nie.
Gebruik
Initialisatie
Aansoeke moet inisialiseer Colorama behulp:
van Colorama invoer init
init ()
As jy op Windows, die oproep om 'init ()' 'sal begin filter ANSI ontsnapping rye uit enige teks gestuur na stdout of stderr en hulle te vervang met ekwivalent Win32 noem.
Roep '' init () '' het geen effek op ander platforms (tensy jy 'motor reset' gebruik, sien hieronder) Die bedoeling is dat alle aansoeke init (moet bel) onvoorwaardelik, dan is hulle gekleurde teks uitset eenvoudig werk op alle platforms.
Gekleurde Uitgawe
Cross-platform druk van gekleurde teks kan dan gedoen word:
van Colorama invoer Fore, Back, Style
Druk Fore.RED + 'n paar rooi teks '
Druk Back.GREEN + en met 'n groen agtergrond '
Druk Style.DIM + en in dowwe teks '
Druk + Fore.DEFAULT + Back.DEFAULT + Style.DEFAULT
Druk 'terug na normaal nou'
of eenvoudig deur die hand druk ANSI rye uit jou eie kode:
Druk '/ 033 [31m' + 'n paar rooi teks '
Druk '/ 033 [30m' # en herstel kleur standaard
of Colorama gelukkig kan gebruik word in samewerking met bestaande ANSI biblioteke soos Termcolor (http://pypi.python.org/pypi/termcolor):
# Gebruik Colorama om Termcolor werk op Windows te maak
van Colorama invoer init
init ()
# Dan gebruik Termcolor vir al die gekleurde teks uitset
van termcolor invoer gekleurde
druk gekleur ("Hallo, World!", "groen", "on_red ')
Beskikbaar opmaak konstantes is:
Vore: swart, rooi, groen, geel, blou, magenta, siaan, WHITE, DEFAULT.
Terug: swart, rooi, groen, geel, blou, magenta, siaan, WHITE, DEFAULT.
Styl: DIM, normale, helder, RESET_ALL
Style.RESET_ALL bring jy die voorgrond, agtergrond en helderheid. Colorama sal hierdie herstel outomaties uit te voer op program uitgang (nie geïmplementeer nie).
Motor reset
Nie geïmplementeer
As jy jouself herhaaldelik stuur reset rye kleur verander aan die einde van elke gedrukte af te draai, dan init (motor reset = True) sal outomatiseer dat:
van Colorama invoer init
init (motor reset = True)
Druk Fore.RED + 'n paar rooi teks '
Druk 'outomaties terug na standaard kleur weer'
Sonder wikkel stdout
Colorama werk deur die wikkel stdout en stderr met volmag voorwerpe, wat ignoreer skryf () om hul werk te doen. Die gebruik van init (motor reset = True) sal hierdie wikkel doen op alle platforms, nie net Windows.
As hierdie proxy voorwerpe wikkel stdout en stderr veroorsaak dat jy probleme, dan is dit afgeskakel kan word met behulp van init (wrap = False) (nie geïmplementeer nie), en jy kan plaas toegang Colorama se AnsiToWin32 proxy direk. 'N kenmerk toegang op hierdie item sal gestuur word na die stroom dit vou, afgesien van .write (), wat op Windows is geïgnoreer eerste voer die ANSI om Win32 omskakeling op teks:
van Colorama invoer init, AnsiToWin32
init (wrap = False)
stroom = AnsiToWin32 (sys.stderr)
Druk >> stroom, Fore.BLUE + 'blou teks stderr'
Ontwikkeling
Toetse vereis Mock module Michael Foord se. Ek het al met behulp nosetests om die toetse uit te voer, hoewel hulle kan werk sonder dat dit die gebruik van:
python-m colorama.tests

Wat is nuut in hierdie release:.

• Bygevoeg sommige dokumentasie vir wyser posisie en duidelik skerm README. Voeg 'reinit en funksies' deinit, soos voorgestel deur Charles FOL en Romanof DA.

Wat is nuut in die weergawe 0.1.18:

• Fix README (geen sodanige attr as Fore.DEFAULT , ens), vriendelik gerapporteer deur nodakai.

Wat is nuut in die weergawe 0.1.17:

• Voorkom druk van vullis ANSI kodes op die installering met pit

Wat is nuut in die weergawe 0.1.16:

• Re-oplaai na vorige fout reg te stel. Maak skoon verwyder nou ou manifes.

Wat is nuut in die weergawe 0.1.15:

• Fix python3 onverenigbaarheid vriendelik gerapporteer deur Gunter Kolousek

Wat is nuut in die weergawe 0.1.14:

• Fix hard-gekodeerde herstel na wit-on- swart kleure. Fore.RESET, Back.RESET en Style.RESET_ALL nou terugkeer na die kleure as wat hulle was toe init () genoem is. Sommige lesse hopelik geleer het oor die toets voor die vrylating.

Wat is nuut in die weergawe 0.1.13:

• Vorige weergawe is heeltemal gebreek (vervat geen bron) . Double oops.

Wat is nuut in die weergawe 0.1.10:

• Stop navolging 'n helder 'teks met helder agtergronde. Display "normale" teks deur win32 normale voorgrond plaas van helder. Drop ondersteuning vir 'n dowwe "teks.

Wat is nuut in weergawe 0.1.9:

• Fix onverenigbaarheid met Python 2.5 en vroeër Verwyder setup. py afhanklikheid setuptools, gebruik nou stdlib distutils

Vereistes :

• Python