colorama

Colorama fournit une API simple croix-plate-forme pour imprimer du texte borne de couleur à partir d'applications Python.
ANSI séquences de caractères d'échappement sont couramment utilisés pour produire un texte borne de couleur sur les Mac et Unix. Colorama fournit des raccourcis pour générer ces séquences, et les fait travailler sur Windows aussi.
Cela a pour effet secondaire heureux que les applications existantes ou de bibliothèques qui utilisent déjà les séquences ANSI pour produire une sortie de couleur sur Linux ou Mac (par ex. L'utilisation de paquets comme 'termcolor') peut maintenant également travailler sur Windows, simplement par l'importation et l'initialisation Colorama.
Statut
En développement. Certaines fonctions, comme indiqué ci-dessous, ne sont pas encore implémentées.
Utilisation
Initialisation
Les demandes doivent initialiser Colorama en utilisant:
de Colorama importation initialisation
init ()
Si vous êtes sur Windows, l'appel à '' init () '' va commencer le filtrage des séquences d'échappement ANSI de tout texte envoyé à stdout ou stderr, et va les remplacer par des appels équivalents Win32.
Calling '' init () '' n'a aucun effet sur d'autres plates-formes (sauf si vous utilisez 'autoreset', voir ci-dessous) L'intention est que toutes les demandes doivent init (appeler) sans condition, alors leur sortie de texte coloré fonctionne tout simplement sur toutes les plateformes.
Sortie couleur
Croix-plate-forme d'impression de texte en couleur peut alors être fait:
Fore de l'importation de Colorama, Retour, Style
print Fore.RED + 'un texte rouge »
Back.GREEN d'impression + et avec un fond vert '
print Style.DIM + 'et dans le texte sombre'
print + Fore.DEFAULT + Back.DEFAULT + Style.DEFAULT
print 'retour à la normale maintenant »
ou tout simplement en imprimant manuellement séquences ANSI à partir de votre propre code:
print '/ 033 [31m' + 'un texte rouge »
print '/ 033 [30m' # et remis à la couleur par défaut
Colorama ou peut être utilisé en conjonction avec heureusement bibliothèques ANSI existantes telles que Termcolor (http://pypi.python.org/pypi/termcolor):
# Utiliser Colorama de faire Termcolor travail sur Windows trop
de Colorama importation initialisation
init ()
# Puis utilisez Termcolor pour toutes les sorties de texte en couleur
de termcolor importation coloré
imprimer en couleur ("Bonjour, monde!», «vert», «on_red ')
Constantes de formatage disponibles sont:
Fore: noir, rouge, vert, jaune, bleu, magenta, cyan, BLANC, DEFAULT.
Retour: noir, rouge, vert, jaune, bleu, magenta, cyan, BLANC, DEFAULT.
Style: DIM, NORMAL, BRIGHT, reset_all
Style.RESET_ALL réinitialise premier plan, arrière-plan et la luminosité. Colorama effectuera automatiquement cette réinitialisation sur la sortie du programme (Non implémenté).
Autoreset
Pas mis en œuvre
Si vous vous trouvez l'envoi répété de séquences de réinitialisation pour éteindre les changements de couleur à la fin de chaque impression, puis init (autoreset = True) permettra d'automatiser que:
de Colorama importation initialisation
init (autoreset = True)
print Fore.RED + 'un texte rouge »
print 'retour automatiquement à la couleur par défaut à nouveau'
Sans emballage stdout
Colorama fonctionne en enveloppant stdout et stderr avec des objets proxy, qui surchargent write () pour faire leur travail. Utilisation init (autoreset = True) le fera emballage sur toutes les plateformes, et pas seulement Windows.
Si ces objets proxy emballage stdout et stderr vous causer des problèmes, alors ce peut être désactivée à l'aide init (wrap = False) (Non implémenté), et vous pouvez accéder directement à la place AnsiToWin32 le mandataire de Colorama. Tout accès d'attribut sur cet objet sera transmis au courant qu'elle enveloppe, en dehors de .write (), qui est surchargée sur Windows pour effectuer d'abord le ANSI pour Win32 conversion sur le texte:
de Colorama importation init, AnsiToWin32
init (wrap = False)
= flux AnsiToWin32 (sys.stderr)
print >> flux, 'le texte en bleu sur stderr' Fore.BLUE +
Développement
Tests nécessitent le module Mock de Michael Foord. Je l'utilise depuis nosetests pour exécuter les tests bien qu'ils puissent travailler sans lui, en utilisant:
colorama.tests python -m

Quoi de neuf dans cette version:.

• Ajout de quelques documents pour le positionnement du curseur et l'écran clair pour README. Ajouter 'reinit' et les fonctions 'de deinit », comme suggéré par Charles FOL et Romanov DA.

Ce qui est nouveau dans la version 0.1.18:

• Fix README (rien de tel que attr Fore.DEFAULT , etc.), veuillez rapporté par nodakai.

Ce qui est nouveau dans la version 0.1.17:

• Empêcher l'impression de codes ordures ANSI lors de l'installation avec pip

Quoi de neuf dans la version 0.1.16:

• Re-télécharger pour corriger l'erreur précédente. Assurez-clean supprime maintenant âgé MANIFESTE.

Ce qui est nouveau dans la version 0.1.15:

• Fix python3 incompatibilité aimablement signalé par Gunter Koloušek

Ce qui est nouveau dans la version 0.1.14:

• Correction réinitialisation codée en dur au blanc-on- couleurs noir. Fore.RESET, Back.RESET et Style.RESET_ALL reviennent maintenant aux couleurs telles qu'elles étaient quand init () a été appelée. Quelques leçons apprises sur le test je l'espère avant la libération.

Ce qui est nouveau dans la version 0.1.13:

• La version précédente a été complètement cassé (contenue aucune source) . Double oops.

Quoi de neuf dans la version 0.1.10:

• Arrêter l'émulation texte «clair» avec arrière-plan lumineux. Afficher le texte «normal» à l'aide de premier plan win32 normale au lieu de clairs. Drop de soutien pour le texte «faible».

Quoi de neuf dans la version 0.1.9:

• Correction d'incompatibilité avec Python 2.5 et versions antérieures Retirer configuration. py dépendance setuptools, utilise maintenant distutils stdlib

Exigences :

• Python