Retour au blog
Articles

Un terminal en couleurs avec les codes ANSI

Utiliser les séquences ANSI pour distinguer les états dans une sortie CLI.

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 :

python
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 :

CodeEffet
0Réinitialiser (par défaut)
1Gras
2Atténué
3Italique
4Souligné
7Vidé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 :

CodeCouleur
30Noir
31Rouge
32Vert
33Jaune
34Bleu
35Magenta
36Cyan
37Blanc
90–97Couleurs 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:

CodeCouleur de fond
40Noir (arrière-plan)
41Rouge (arrière-plan)
42Vert (arrière-plan)
43Jaune (arrière-plan)
44Bleu (arrière-plan)
45Magenta (arrière-plan)
46Cyan (arrière-plan)
47Blanc (arrière-plan)
100–107Couleurs de fond vives correspondantes

Que font les codes situés entre 38 et 89 ?

  • 38 et 48 : couleurs personnalisées

    • 38 définit la couleur du premier plan.
    • 48 définit la couleur de l'arrière-plan.

    Il faut ensuite ajouter des paramètres, par exemple pour choisir parmi 256 couleurs :

    python
    print("\033[38;5;198mA pink text\033[0m")
    
    • 38;5;198 sélectionne la couleur 198 de cette palette.

    Une couleur RVB sur 24 bits s'écrit ainsi :

    python
    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éfaut
    • 49: Réinitialiser à la couleur d'arrière-plan par défaut

Récapitulons :

GammeFonction
30–37Couleurs standard de premier plan
90–97Couleurs vives au premier plan
38Couleurs de premier plan avancées (256 couleurs / RGB)
39Réinitialiser la couleur du premier plan
40–47Couleurs de fond standard
100–107Couleurs de fond vives
48Couleurs de fond avancées (256 couleurs / RGB)
49Réinitialiser la couleur de l'arrière-plan
50–89Effets et extensions selon le terminal

Ce programme affiche la palette de 256 couleurs :

python
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 :

ANSI 256 色對照表

Combiner les styles

La forme générale est :

Code
\033[<format>;<text color>m

Exemple :

python
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 :

python
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 ; colorama aide 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 :

python
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 :

  1. colorama

    Aide à gérer l'affichage entre plateformes, notamment sur Windows :

    python
    from colorama import init, Fore, Style
    init()
    print(Fore.RED + "Hello in red!" + Style.RESET_ALL)
    
  2. termcolor

    Fournit la fonction colored() :

    python
    from termcolor import colored
    print(colored("Warning", "red", attrs=["bold"]))
    
  3. rich

    Prend en charge les couleurs, les tableaux, les barres de progression et Markdown.

    python
    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.