colorama

Colorama oferă un simplu API cross-platform pentru a imprima text terminale colorate de aplicații Python.
ANSI secvențe de caractere de evacuare sunt de obicei folosite pentru a produce texte terminalul de culoare pe Mac-uri și Unix. Colorama oferă câteva comenzi rapide pentru a genera aceste secvențe, și le face de lucru pe Windows prea.
Acest lucru are happy efect secundar care aplicatiile existente sau biblioteci care folosesc deja secvențe ANSI pentru a produce ieșire colorate pe Linux sau Mac-uri (de exemplu. Folosind pachete cum ar fi "termcolor") acum pot lucra, de asemenea, pe Windows, pur și simplu prin importul și inițializarea Colorama.
Stare
În dezvoltare. Unele caracteristici, așa cum sa arătat mai jos, nu sunt puse în aplicare încă.
Utilizare
Inițializare
Cererile trebuie inițializa Colorama folosind:
de la Colorama init import
înăuntru ()
Dacă sunteți pe Windows, apelul la '' init (), '' va începe filtrarea secvențe ANSI scăpa din orice text trimise stdout sau stderr, și le va înlocui cu apeluri echivalent Win32.
Apelarea '' init () "" nu are niciun efect asupra altor platforme (cu excepția cazului când utilizați "AUTORESET", a se vedea mai jos) Intenția este ca toate aplicațiile să init (apel) necondiționat, apoi producția lor de text de culoare, pur și simplu funcționează pe toate platformele.
Ieșire colorat
Imprimare cross-platform de text colorat poate fi făcută:
de la Fore import Colorama, Back, Style
print Fore.RED + "un text roșu"
Back.GREEN imprimare + și cu un fundal verde "
print Style.DIM + "și în textul dim"
print + Fore.DEFAULT + Back.DEFAULT + Style.DEFAULT
print "a revenit la normal acum"
sau pur și simplu prin imprimarea manuală secvențe ANSI din propriul cod:
print "/ 033 [31m '+' un text roșu"
print "/ 033 [30m" # și resetare la valorile implicite de culoare
sau Colorama pot fi folosite fericit în legătură cu bibliotecile ANSI existente, precum Termcolor (http://pypi.python.org/pypi/termcolor):
# Folosesc Colorama pentru a face Termcolor lucru pe Windows prea
de la Colorama init import
înăuntru ()
# Apoi utilizați Termcolor pentru toate de text de culoare
din termcolor colorate import
imprima culoare ("Hello, World!", "verde", "on_red")
Disponibil constante de formatare sunt:
Fore: negru, rosu, verde, galben, albastru, magenta, cyan, alb, DEFAULT.
Spate: negru, rosu, verde, galben, albastru, magenta, cyan, alb, DEFAULT.
Stil: DIM, NORMAL, BRIGHT, RESET_ALL
Style.RESET_ALL resetează prim-plan, de fundal și luminozitatea. Colorama va efectua automat acest resetare la ieșire programul (Neimplementat).
AUTORESET
Nu a implementat
Dacă vă aflați în mod repetat trimiterea secvențe de resetare pentru a opri schimbarea culorii la sfârșitul fiecărui print, apoi init (AUTORESET = True), va automatiza că:
de la Colorama init import
init (AUTORESET = True)
print Fore.RED + "un text roșu"
print "automat la culoarea implicită din nou"
Fără ambalaj stdout
Colorama lucrari de ambalaj stdout și stderr cu obiecte proxy, care suprascrie scriere () pentru a face munca lor. Folosind init (AUTORESET = True) va face acest lucru ambalaj pe toate platformele, nu doar pentru Windows.
Dacă aceste obiecte proxy ambalaj stdout și stderr pentru că ai probleme, atunci acest lucru poate fi dezactivat folosind init (folie = False) (Neimplementat), și puteți accesa loc AnsiToWin32 proxy Colorama direct. Orice acces atribut pe acest obiect va fi transmis fluxul se înfășoară, în afară de .write (), care pe Windows este deblocat pentru a efectua primul ANSI pentru Win32 conversie pe textul:
de la Colorama init import, AnsiToWin32
init (folie = False)
flux = AnsiToWin32 (sys.stderr)
print >> curent, Fore.BLUE + 'text albastru pe stderr "
Dezvoltare
Testele necesita modul Mock Michael Foord lui. Am fost folosind nosetests pentru a rula testele deși acestea pot funcționa fără ea, folosind:
colorama.tests python -m

Ce este nou în această versiune:.

• adăugat câteva documentare pentru poziționarea cursorului și ecranul clar pentru readme. Adauga 'REINIT "și funcțiile de" deinit, după cum a sugerat de Charles FOL și Romanov DA.

Ce este nou în versiunea 0.1.18:

• Fix README (o astfel de attr ca Fore.DEFAULT , etc), cu amabilitate raportate de nodakai.

Ce este nou în versiunea 0.1.17:

• Prevenirea imprimarea codurilor de gunoi ANSI la instalarea cu pip

Ce este nou în versiunea 0.1.16:

• Re-upload pentru a repara eroarea anterioară. Face curat indeparteaza acum MANIFEST vechi.

Ce este nou în versiunea 0.1.15:

• Fix python3 incompatibilitate amabilitate raportate de Gunter Koloušek

Ce este nou în versiunea 0.1.14:

• Fix resetare greu cu coduri de la alb-on culorile negru. Fore.RESET, Back.RESET și Style.RESET_ALL reveni acum la culorile așa cum au fost atunci când init () a fost numit. Unele lecții sperăm aflat despre testarea înainte de a elibera.

Ce este nou în versiunea 0.1.13:

• Versiunea anterioară a fost complet rupt (conținea nici o sursă) . Dublu oops.

Ce este nou în versiunea 0.1.10:

• Nu mai emularea text 'strălucitor' cu fundaluri luminoase. Textul de afișare "normal" utilizarea informațiilor generate normală Win32 loc de luminoase. Drop de sprijin pentru text "dim".

Ce este nou în versiunea 0.1.9:

• Fix incompatibilitate cu Python 2.5 și mai devreme Eliminare configurare. dependența py pe setuptools, folosește acum distutils stdlib

Cerințe :

• Python