Colorama zapewnia prosty cross-platform API do drukowania kolorowego tekstu z aplikacji terminala Python.
ANSI sekwencje znaków ucieczki są powszechnie wykorzystywane do produkcji kolorowego terminalu tekst na Mac i Unix. Colorama zapewnia kilka skrótów do generowania te sekwencje, i sprawia, że działa na Windows też.
Ma to szczęśliwe efekt uboczny, że istniejące aplikacje lub biblioteki, które już wykorzystują sekwencje ANSI produkować kolorowe wyjście w systemie Linux lub Mac (np. Korzystanie z pakietów, takich jak "termcolor") może teraz pracować na Windows, po prostu importowanie i inicjalizacji COLORAMA.
Stan
W rozwoju. Niektóre funkcje, jak wskazano poniżej, nie są jeszcze wprowadzone w życie.
Zastosowanie
Inicjalizacji
Wnioski powinny zainicjować Colorama za pomocą:
z COLORAMA importu pliku init
w tym ()
Jeśli jesteś na Windows, wezwanie do '' init () '' rozpocznie sekwencje ANSI filtrowania uciec z każdego tekstu przesłanego do stdout lub stderr, i będzie je zastąpić nazywa odpowiednik Win32.
Nazywając '' init () '' nie ma wpływu na inne platformy (chyba, że używasz "Autoreset", patrz poniżej) intencją jest to, że wszystkie wnioski powinny zadzwonić init () bezwarunkowo, to ich po prostu tekst w kolorze wyjścia działa na wszystkich platformach.
Wyjście w kolorze
Drukowanie na różnych platformach z kolorowego tekstu mogą być wykonane:
z COLORAMA importu plan, plecy, Style
drukuj Fore.RED + "niektóre czerwone tekst"
Back.GREEN druku + i zielonym tle "
drukuj Style.DIM + "i przy słabym tekstem"
print + Fore.DEFAULT + Back.DEFAULT + Style.DEFAULT
print "wraca do normy teraz '
lub po prostu ręcznie drukowania sekwencji ANSI z własnego kodu:
print '/ 033 [31m' + 'niektóre czerwone tekst "
print '/ 033 [30m' # i przywrócone do wartości domyślnych kolor
lub Colorama może być stosowany w połączeniu z radością istniejących bibliotek ANSI takich jak Termcolor (http://pypi.python.org/pypi/termcolor):
# Używać COLORAMA aby Termcolor pracy w systemie Windows za
z COLORAMA importu pliku init
w tym ()
# Użyj Termcolor dla wszystkich kolorowych wydruków z tekstem
z termcolor import kolorowe
drukowanie w kolorze ("Hello, World!", "zielony", "on_red")
Dostępne stałe formatowania są:
Fore: czarny, czerwony, zielony, żółty, niebieski, purpurowy, błękitny, BIAŁY, domyślnie.
Powrót: czarny, czerwony, zielony, żółty, niebieski, purpurowy, błękitny, BIAŁY, domyślnie.
Styl: DIM, NORMAL, BRIGHT, RESET_ALL
Style.RESET_ALL resetuje pierwszego planu, tła i jasność. Colorama wykona to automatycznie przy wyjściu resetowania programu (nie zaimplementowane).
Autoreset
Nie zaimplementowane
Jeśli znajdziesz się wielokrotnie wysyłania resetowania sekwencji wyłączyć zmiany koloru na końcu każdego wydruku, a następnie init (autoreset = true) będzie zautomatyzować, że:
z COLORAMA importu pliku init
init (autoreset = True)
drukuj Fore.RED + "niektóre czerwone tekst"
print "automatycznie z powrotem do domyślnego koloru ponownie"
Bez owijania stdout
Colorama działa owijając stdout i stderr z obiektami proxy, które piszą nadpisywania (), aby wykonywać swoją pracę. Korzystanie init (autoresetowania = true) zrobi to opakowanie na wszystkich platformach, nie tylko systemu Windows.
Jeśli te obiekty proxy owijania stdout i stderr spowodować problemy, to można wyłączyć przy użyciu init (okład = false) (nie jest zaimplementowane), można zamiast dostęp AnsiToWin32 proxy COLORAMA bezpośrednio. Każdy dostęp atrybut tego obiektu zostaną przekazane do strumienia owija oprócz .write (), która w systemie Windows nie jest uwzględniana w pierwszej kolejności przeprowadzić konwersję ANSI do Win32 na tekst:
z COLORAMA importu init AnsiToWin32
init (okład = False)
Strumień = AnsiToWin32 (sys.stderr)
drukuj >> strumień, "niebieski tekst na stderr" Fore.BLUE +
Rozwoju
Badania wymagają modułu Mock Michaela Foord za. Używam nosetests uruchomić testy, chociaż mogą pracować bez niego, za pomocą:
python -m colorama.tests
Co nowego w tym wydaniu:.
- Dodane jakąś dokumentację do pozycjonowania kursora i jasny ekran readme. Dodaj '' i reinit funkcje "deinit ', jak sugeruje Karola FOL i Romanowów DA.
Co nowego w wersji 0.1.18:
- README Fix (nie ma takiego atr jak Fore.DEFAULT itp), uprzejmie donosi nodakai.
Co nowego w wersji 0.1.17:
- Zapobiegaj drukowanie kodów ANSI po zainstalowaniu śmieci z pip
Co nowego w wersji 0.1.16:
- ponownie przesłać do ustalenia poprzedniego błędu. Złóż teraz usuwa stare czyste MANIFEST.
Co nowego w wersji 0,1,15:
- Fix python3 niezgodność uprzejmie donosi Gunter Koloušek
Co nowego w wersji 0.1.14:
- Fix zakodowane resetu do biało-on- czarne kolory. Fore.RESET, Back.RESET i Style.RESET_ALL teraz przywrócić kolory, jak były, gdy init () została wywołana. Niektóre lekcje mam nadzieję, że dowiedział się o badania przed dopuszczeniem.
Co nowego w wersji 0.1.13:
- Poprzednia wersja została całkowicie uszkodzony (nie zawierał źródło) , Pokój oops.
Co nowego w wersji 0.1.10:
- Zatrzymaj emulacji "jasny" tekst z jasnym tle. Ekran 'normalne' tekstu przy użyciu win32 normalne pierwszy plan zamiast jasne. Spadku poparcia dla "dim" tekstu.
Co nowego w wersji 0.1.9:
- Fix niezgodności z Python 2.5 i wcześniejszych Usuń konfigurację. Zależność py na setuptools, teraz używa stdlib distutils
Wymagania :
- Python
Komentarze nie znaleziono