colorama

Coloraman tarjoaa helpon cross-platform API tulostaa värillistä terminaaliin tekstiä Python sovelluksia.
ANSI escape merkkijonojen yleisesti käytetään tuottamaan värillisiä terminaaliin tekstiä Maceissa ja Unix. Colorama tarjoaa joitakin oikoteitä tuottaa nämä sekvenssit, ja tekee niistä toimi Windows liikaa.
Tämä on onnellinen sivuvaikutuksena että olemassa olevia sovelluksia tai kirjastoja, jotka jo käyttävät ANSI sekvenssit tuottamaan värillinen lähtö Linux tai Mac-tietokoneiden (esim. Käyttämällä paketteja, kuten "termcolor ') voivat nyt myös toimia Windows, yksinkertaisesti tuomalla ja alustus Colorama.
tila
Kehitystyössä. Jotkin ominaisuudet, kuten alla todetaan, ei vielä sovelleta.
Käyttö
Alustus
Hakemukset tulee alustaa Colorama avulla:
alkaen Colorama tuonti init
init ()
Jos olet Windowsissa, kehotus "" init () '' alkaa suodattamaan ANSI tilanvaihdot mistä tahansa tekstiä lähetetään stdout tai stderr, ja korvata ne vastaavalla Win32 puhelut.
Soittaminen '' init () '' ei vaikuta muilla alustoilla (ellet käytä "itsekuittausviiveen", katso alla) Tarkoituksena on, että kaikki hakemukset tulee soittaa init () ehdoitta, niin niiden värillisiä tekstinä yksinkertaisesti toimii kaikilla alustoilla.
Värilliset Lähtö
Cross-platform tulostus värillistä tekstiä voidaan tehdä:
alkaen Colorama tuonti Fore, Back, tyyli
print Fore.RED + "punaista tekstiä"
print Back.GREEN + ja vihreä tausta "
print Style.DIM + "ja hämärässä teksti"
print + Fore.DEFAULT + Back.DEFAULT + Style.DEFAULT
print "takaisin normaaliin nyt '
tai yksinkertaisesti manuaalisesti tulostamalla ANSI sekvenssit omalta code:
print "/ 033 [31m" + "punaista tekstiä"
print "/ 033 [30m" # ja reset default väri
tai Colorama voidaan käyttää onnellisesti yhdessä nykyisten ANSI kirjastojen kuten Termcolor (http://pypi.python.org/pypi/termcolor):
# Käytä Colorama tehdä Termcolor työtä Windows liian
alkaen Colorama tuonti init
init ()
# Käytä Termcolor sopii kaikille värillisille tekstinä
alkaen termcolor tuonti värillinen
tulostaa värillinen ("Hei, maailma! ',' vihreä ',' on_red ')
Käytettävissä alustus vakiot ovat:
Fore: musta, punainen, vihreä, keltainen, sininen, magenta, syaani, WHITE, DEFAULT.
Back: musta, punainen, vihreä, keltainen, sininen, magenta, syaani, WHITE, DEFAULT.
Tyyli: DIM, NORMAALI, KIRKAS, RESET_ALL
Style.RESET_ALL nollaa etualan, taustan ja kirkkaus. Colorama suorittaa tämä nollataan automaattisesti lopetettaessa (Ei toteutettu).
Autoreset
Ei toteutettu
Jos löydät itsesi toistuvasti lähetät reset sekvenssejä sammuttaa väri muuttuu lopussa jokaisen tulostuksen jälkeen init (itsekuittausviiveen = True) automatisoi että:
alkaen Colorama tuonti init
init (itsekuittausviiveen = True)
print Fore.RED + "punaista tekstiä"
print "automaattisesti takaisin default color uudelleen"
Ilman päällystä stdout
Colorama toimii kietomalla stdout ja stderr proxy esineitä, että ohitus kirjoittaa () tehdä työnsä. Käyttämällä init (itsekuittausviiveen = True) tekee tähän kääreeseen kaikilla alustoilla, ei vain Windows.
Jos nämä proxy esineitä kääriminen stdout ja stderr aiheuttaa sinulle ongelmia, niin tämä voidaan poistaa käyttämällä init (wrap = False) (Ei toteutettu), ja voit sen sijaan käyttää Coloraman AnsiToWin32 proxy suoraan. Mikä tahansa määrite pääsy tämä esine toimitetaan stream se kietoo, paitsi .write (), joka on Windows on yliohjatut ensin suorittaa ANSI Win32 muuntaminen tekstistä:
alkaen Colorama tuonti init, AnsiToWin32
init (wrap = False)
stream = AnsiToWin32 (sys.stderr)
print >> stream, Fore.BLUE + "sininen teksti vakiovirhetulosteessa"
kehitys
Testit vaativat Michael Foord n ​​Mock moduuli. Olen käyttänyt nosetests ajaa testejä vaikka ne voivat työskennellä ilman sitä käyttäen:
python -m colorama.tests.

Mikä on uusi tässä julkaisussa:

• Lisäsin dokumentaatiota kohdistimen ja selkeä näyttö readme. Add "reinit" ja "deinit" toimintoja, ehdottivat Charles FOL ja Romanov DA.

Mikä on uusi versiossa 0.1.18:

• Fix README (ei esim attr kuten Fore.DEFAULT jne), ystävällisesti raportoinut nodakai.

Mikä on uusi versiossa 0.1.17:

• Estä tulostus roskat ANSI koodien kun asennat kanssa pip

Mikä on uusi versiossa 0.1.16:

• Re-upload korjata edellinen virhe. Tee puhdas nyt poistaa vanhoja MANIFEST.

Mikä on uusi versiossa 0.1.15:

• Korjaa python3 yhteensopimattomuus ystävällisesti raportoinut Gunter Koloušek

Mikä on uusi versiossa 0.1.14:

• Fix kovakoodatuilla reset valkoiseksi on- musta väri. Fore.RESET, Back.RESET ja Style.RESET_ALL nyt palata värien kuin ne olivat init () kutsuttiin. Joitakin johtopäätöksiä toivottavasti oppinut testaus ennen luovutusta.

Mikä on uusi versiossa 0.1.13:

• Edellinen versio oli täysin rikki (ei sisältänyt lähde) . Double oops.

Mikä on uusi versiossa 0.1.10:

• Lopeta jäljittelemällä "kirkas" tekstin kirkkaan taustoja. Näyttö "normaalia" tekstiä win32 normaalia etualalla sijaan kirkkaita. Pudota tuki "hämärä" text.

Mikä on uusi versiossa 0.1.9:

• Fix yhteensopimattomuus Python 2.5 ja aikaisemmin Poista asennus. py riippuvuus setuptools, nyt käyttää stdlib distutils

vaatimukset

• Python