Dans un terminal, les messages d'état, les avertissements et les erreurs se ressemblent vite lorsqu'ils ont tous la même couleur. Quelques séquences de contrôle suffisent à faire ressortir les informations utiles. Voyons les séquences d'échappement ANSI, puis construisons une petite palette pour la ligne de commande.
Que sont les séquences ANSI ?
ANSI signifie American National Standards Institute. Le terme « séquences d'échappement ANSI » désigne ici les codes de contrôle reconnus par de nombreux terminaux.
Une séquence commence souvent par \033[ ou \x1b[, suivi de paramètres qui indiquent la couleur ou le style.
Voici un exemple :
print("\033[1;31mHello World\033[0m")
Ce code affiche « Hello World » en rouge et en gras. Le \033[0m final réinitialise le style pour les affichages suivants.
Codes de mise en forme courants
Ces valeurs modifient le style du texte :
| Code | Effet |
|---|---|
| 0 | Réinitialiser (par défaut) |
| 1 | Gras |
| 2 | Atténué |
| 3 | Italique |
| 4 | Souligné |
| 7 | Vidéo inverse |
Les codes de style peuvent également être combinés avec des codes de couleur.
Codes de contrôle des couleurs
Les couleurs de premier plan standard occupent les codes 30 à 37. Les variantes lumineuses occupent les codes 90 à 97.
Voici les couleurs standard :
| Code | Couleur |
|---|---|
| 30 | Noir |
| 31 | Rouge |
| 32 | Vert |
| 33 | Jaune |
| 34 | Bleu |
| 35 | Magenta |
| 36 | Cyan |
| 37 | Blanc |
| 90–97 | Couleurs vives |
Les codes de couleur d'arrière-plan correspondent à 40–47 (couleurs standard) et 100–107 (couleurs vives), et ils suivent le même modèle que ci-dessus:
| Code | Couleur de fond |
|---|---|
| 40 | Noir (arrière-plan) |
| 41 | Rouge (arrière-plan) |
| 42 | Vert (arrière-plan) |
| 43 | Jaune (arrière-plan) |
| 44 | Bleu (arrière-plan) |
| 45 | Magenta (arrière-plan) |
| 46 | Cyan (arrière-plan) |
| 47 | Blanc (arrière-plan) |
| 100–107 | Couleurs de fond vives correspondantes |
Que font les codes situés entre 38 et 89 ?
-
38 et 48 : couleurs personnalisées
38définit la couleur du premier plan.48définit la couleur de l'arrière-plan.
Il faut ensuite ajouter des paramètres, par exemple pour choisir parmi 256 couleurs :
print("\033[38;5;198mA pink text\033[0m")38;5;198sélectionne la couleur 198 de cette palette.
Une couleur RVB sur 24 bits s'écrit ainsi :
print("\033[38;2;255;105;180mHello in pink!\033[0m")38;2;<r>;<g>;<b>précise les composantes rouge, verte et bleue.
-
39 et 49 : retour aux couleurs par défaut
39: Réinitialiser à la couleur de premier plan par défaut49: Réinitialiser à la couleur d'arrière-plan par défaut
Récapitulons :
| Gamme | Fonction |
|---|---|
| 30–37 | Couleurs standard de premier plan |
| 90–97 | Couleurs vives au premier plan |
| 38 | Couleurs de premier plan avancées (256 couleurs / RGB) |
| 39 | Réinitialiser la couleur du premier plan |
| 40–47 | Couleurs de fond standard |
| 100–107 | Couleurs de fond vives |
| 48 | Couleurs de fond avancées (256 couleurs / RGB) |
| 49 | Réinitialiser la couleur de l'arrière-plan |
| 50–89 | Effets et extensions selon le terminal |
Ce programme affiche la palette de 256 couleurs :
for i in range(256):
print(f"\033[48;5;{i}m {i:3} \033[0m", end=" ")
if i % 16 == 15:
print()
Le résultat ressemble à ceci :
Combiner les styles
La forme générale est :
\033[<format>;<text color>m
Exemple :
def colorstr(text, fmt=1, color=34):
return f"\033[{fmt};{color}m{text}\033[0m"
print(colorstr("This is a bold blue text"))
On peut aussi combiner style, premier plan et arrière-plan :
print("\033[1;34;43mBlue text on yellow background, fashion explained\033[0m")
Remarques
Quelques précautions rendent la sortie plus lisible :
- Réinitialiser le style : sans
\033[0m, les messages suivants peuvent hériter de la couleur. - Vérifier l'environnement : Jupyter et les différents terminaux ne prennent pas tous en charge les mêmes effets.
- Tester sur Windows : les terminaux récents gèrent mieux ANSI ;
coloramaaide avec certains environnements plus anciens. - Garder les journaux lisibles : pour les fichiers de log, le texte brut évite d'y enregistrer des codes d'échappement.
Pour aller plus loin
Une petite fonction et des énumérations peuvent centraliser les couleurs utilisées par un programme :
from enum import Enum
class COLOR(Enum):
RED = 31
GREEN = 32
BLUE = 34
class FORMAT(Enum):
BOLD = 1
UNDERLINE = 4
def colorstr(obj, color=COLOR.BLUE, fmt=FORMAT.BOLD):
return f"\033[{fmt.value};{color.value}m{obj}\033[0m"
Quelques usages :
- Erreurs et avertissements : une couleur attire l'attention sur le problème.
- Messages de réussite : un indicateur vert facilite le repérage.
- Menus interactifs : le style peut distinguer les choix et l'invite de saisie.
Bibliothèques utiles
Plusieurs bibliothèques Python évitent de gérer ces codes à la main.
En voici trois :
-
coloramaAide à gérer l'affichage entre plateformes, notamment sur Windows :
from colorama import init, Fore, Style init() print(Fore.RED + "Hello in red!" + Style.RESET_ALL) -
termcolorFournit la fonction
colored():from termcolor import colored print(colored("Warning", "red", attrs=["bold"])) -
richPrend en charge les couleurs, les tableaux, les barres de progression et Markdown.
from rich import print print("[bold red]This is a bold red text[/bold red]")
Résumé
Commencez par quelques styles cohérents pour les erreurs, les réussites et les états en attente. Vérifiez leur lisibilité sur fond clair et sombre. Le texte doit aussi rester compréhensible sans couleur, puisque les thèmes et les terminaux varient.
