colorama

COLORAMA suteikia paprastą cross-platform API spausdinti spalvotas terminalo tekstą iš Python'o programas.
ANSI pabėgti simbolių sekos yra dažniausiai naudojamas gaminti spalvotą terminalo tekstą Mac ir Unix. COLORAMA pateikiama keletas nuorodų generuoti šias sekas, ir daro juos dirbti Windows taip pat.
Tai turi laimingą šalutinį poveikį, kad esamos programos ar bibliotekos, kurios jau naudoja ANSI sekas gaminti spalvotą produkciją Linux ar Mac (pvz., Naudojant paketus kaip "termcolor) dabar taip pat gali dirbti su Windows, tiesiog importuoti ir inicijavimas COLORAMA.
Būsena
Be plėtrai. Kai kurios funkcijos, kaip nurodyta toliau, yra dar neįdiegta.
Naudojimas
Pradiniai
Programos turėtų inicijuoti COLORAMA naudojant:
nuo COLORAMA importo init
init ()
Jei esate Windows, į "init ()" Skambinti "pradės filtruoti ANSI pabėgti sekas iš bet siunčiama stdout ar stderr tekstą, ir pakeisti juos su lygiaverčiu Win32 skambučius.
Skambinimas '' init () "neturi kitų platformų poveikį (nebent jūs naudojate" automatinio atstatymo ", žiūrėti žemiau) siekia, kad visos paraiškos turėtų skambinti init () besąlygiškai, tada jų spalvos teksto išvesties tiesiog veikia visose platformose.
Spalvotas išvestis
Cross-platform spausdinimas iš spalvoto teksto, tada galima padaryti:
nuo COLORAMA importo Priekinės, nugaros, stilius
Spausdinti Fore.RED + ", kai raudonai tekstas"
Spausdinti Back.GREEN + ir žaliame fone "
Spausdinti Style.DIM + `ir artimosios tekstą"
Spausdinti + Fore.DEFAULT + Back.DEFAULT + Style.DEFAULT
Spausdinti ", grįžti prie normalaus dabar"
ar tiesiog rankiniu būdu spausdinti ANSI sekas iš savo kodą:
Spausdinti '/ 033 [31m "+" kai raudona tekstas "
Spausdinti '/ 033 [30m "# ir nustatyti į numatytuosius spalvą
arba COLORAMA gali būti naudojamas laimingai kartu su esamomis ANSI bibliotekų, pvz Termcolor (http://pypi.python.org/pypi/termcolor):
# Naudoti COLORAMA padaryti Termcolor darbą Windows per
nuo COLORAMA importo init
init ()
# Tada naudokite Termcolor visiems spalvotas tekstas produkcijos
nuo termcolor importo spalvos
spausdinti spalvotas ("Hello, World!", "žalia", "on_red)
Laisvi formatavimo konstantos yra:
Priekinės: juoda, raudona, žalia, geltona, mėlyna, rausvai raudona, žalsvai mėlyna, BALTA, pagal nutylėjimą.
Atgal: juoda, raudona, žalia, geltona, mėlyna, rausvai raudona, žalsvai mėlyna, BALTA, pagal nutylėjimą.
Stilius: DIM, normalus, šviesus, RESET_ALL
Style.RESET_ALL atstato įgytas žinias, kvalifikaciją ir ryškumą. COLORAMA atliks šį naujo automatiškai programos išėjimo (Ne įgyvendinti).
Automatinio atstatymo
Ne įgyvendinti
Jei jums rasti sau nuolat siųsti atstatykite sekas išjungti spalvų pokyčius ne kiekvieno spaudinio gale, tada init (automatinio atstatymo = true), bus automatizuoti, kad:
nuo COLORAMA importo init
init (automatinio atstatymo = true)
Spausdinti Fore.RED + ", kai raudonai tekstas"
Spausdinti "automatiškai grįžti į numatytąjį spalvos vėl"
Be vyniojimo STDOUT
COLORAMA veikia vyniojimo STDOUT ir stderr su proxy objektų, kurios yra viršesnės rašyti () atlikti savo darbą. Naudojant init (automatinio atstatymo = true) tai darys vyniojimo visose platformose, o ne tik "Windows".
Jei šie proxy objektai vyniojimo STDOUT ir stderr sukelti jums problemų, tai gali būti išjungta, naudojant init (wrap = false) (neįgyvendintas), ir jūs galite vietoj prieiti COLORAMA anketa AnsiToWin32 proxy tiesiogiai. Bet atributas prieiga šiame objekte bus perduota upelio jis antklodės, išskyrus .write (), kuris "Windows" yra svarbesni pirmiausia atlikti ANSI į Win32 konvertavimo į tekstą:
nuo COLORAMA importo init, AnsiToWin32
init (įvyniojimas = false)
srautas = AnsiToWin32 (sys.stderr)
Spausdinti >> upelis, Fore.BLUE + ", mėlynas tekstas stderr"
kūrimas
Testai reikalauja Michael Foord anketa Mock modulį. Aš naudoju nosetests paleisti bandymus, nors jie gali dirbti ir be jo, naudojant:
python -m colorama.tests

Kas naujo , šioje laidoje.

• Pridėta šiek tiek žymeklio padėties dokumentus ir aiškus ekranas README. Įdėti 'reinit "ir" deinit "funkcijas, kaip siūloma Charles Fol ir Romanovas DA.

Kas naujo versijos 0.1.18:

• Nustatyti README (toks attr kaip Fore.DEFAULT ir tt), maloniai pranešė nodakai.

Kas naujo versijos 0.1.17:

• Neleisti spausdinimas šiukšlių ANSI kodai Įdiegus su pip

Kas naujo 0.1.16 versija:

• Re-upload fiksuoti ankstesnę klaidą. Padaryti švarus dabar pašalina senas akivaizdus.

Kas naujo versijos 0.1.15:

• Nustatyti python3 nesuderinamumas maloniai pranešė Gunter Koloušek

Kas naujo versijos 0.1.14:

• Nustatyti sunkiai koduotą Atstatyti baltos ON- juodos spalvos. Fore.RESET, Back.RESET ir Style.RESET_ALL dabar grįžti prie spalvų, kaip jie buvo, kai init () buvo vadinamas. Kai pamokos tikiuosi sužinojo apie bandymai prieš išleidžiant.

Kas naujo versijos 0.1.13:

• Ankstesnis versija buvo visiškai neveikia (pateikta jokios šaltinis) , Dvivietis Oi.

Kas naujo 0.1.10 versija:

• Sustabdyti mėgdžioti šviesi tekstą ryškių sluoksnių. Ekranas "normalus" tekstą naudodami Win32 normaliai įgytas žinias, o ne šviesus. Drop paramą "artimosios" tekstas.

Kas naujo 0.1.9 versija:

• Nustatyti nesuderinamumą su Python 2.5 ir anksčiau Pašalinti setup. PY priklausomybė nuo setuptools, dabar naudoja stdlib distutils

Reikalavimai

• Python,