Votre guide de la fonction d’impression Python

L'exemple le plus simple d'utilisation de Pythonprint() ne nécessite que quelques touches:

>>>

Vous ne passez aucun argument, mais vous devez tout de même mettre des parenthèses vides à la fin, ce qui indique à Python de faire en faitexecute the function plutôt que de simplement s'y référer par son nom.

Cela produira un caractère de nouvelle ligne invisible, qui à son tour fera apparaître une ligne vierge sur votre écran. Vous pouvez appelerprint() plusieurs fois comme ceci pour ajouter un espace vertical. C'est comme si vous tapiez[.kbd .key-enter]#Enter # sur votre clavier dans un traitement de texte.

Comme vous venez de le voir, appelerprint() sans arguments aboutit à unblank line, qui est une ligne composée uniquement du caractère de nouvelle ligne. Ne confondez pas cela avec unempty line, qui ne contient aucun caractère, pas même la nouvelle ligne!

Vous pouvez utiliser les littérauxstring de Python pour visualiser ces deux:

Le premier est long d'un caractère, tandis que le second n'a pas de contenu.

Note: Pour supprimer le caractère de nouvelle ligne d'une chaîne en Python, utilisez sa méthode.rstrip(), comme ceci:

>>>

Cela supprime tout espace de fin du bord droit de la chaîne de caractères.

Dans un scénario plus courant, vous souhaitez communiquer un message à l'utilisateur final. Il existe plusieurs moyens d'y parvenir.

Tout d'abord, vous pouvez passer un littéral de chaîne directement àprint():

>>>

Cela imprimera le message textuellement sur l'écran.

Deuxièmement, vous pouvez extraire ce message dans sa propre variable avec un nom significatif pour améliorer la lisibilité et promouvoir la réutilisation du code:

>>>

Enfin, vous pouvez passer une expression, commestring concatenation, à évaluer avant d'imprimer le résultat:

>>>

En fait, il existe une douzaine de façons de formater les messages en Python. Je vous encourage vivement à jeter un œil àf-strings, introduit dans Python 3.6, car ils offrent la syntaxe la plus concise de toutes:

>>>

De plus, les chaînes f vous empêcheront de commettre une erreur courante, qui est d'oublier de taper des opérandes concaténés cast. Python est un langage fortement typé, ce qui signifie qu'il ne vous permettra pas de faire ceci:

>>>

C'est faux parce que l'ajout de nombres aux chaînes n'a pas de sens. Vous devez d'abord convertir explicitement le nombre en chaîne, afin de les joindre ensemble:

>>>

Sauf si vous voushandle such errorsvous-même, l'interpréteur Python vous informera d'un problème en affichant untraceback.

Note:str() est une fonction intégrée globale qui convertit un objet en sa représentation sous forme de chaîne.

Vous pouvez l'appeler directement sur n'importe quel objet, par exemple un numéro:

>>>

Les types de données intégrés ont une représentation de chaîne prédéfinie, mais plus loin dans cet article, vous découvrirez comment en fournir une pour vos classes personnalisées.

Comme pour toute fonction, peu importe que vous passiez un littéral, une variable ou une expression. Contrairement à de nombreuses autres fonctions, cependant,print() acceptera tout quel que soit son type.

Jusqu'à présent, vous n'avez regardé que la chaîne, mais qu'en est-il des autres types de données? Essayons des littéraux de différents types intégrés et voyons ce qui en sort:

>>>

Attention cependant à la constanteNone. Bien qu'il soit utilisé pour indiquer une absence de valeur, il apparaîtra comme'None' plutôt que comme une chaîne vide:

>>>

Commentprint() sait-il travailler avec tous ces différents types? Eh bien, la réponse courte est que non. Il appelle implicitementstr() dans les coulisses pour taper cast n'importe quel objet en une chaîne. Ensuite, il traite les cordes de manière uniforme.

Plus loin dans ce didacticiel, vous apprendrez à utiliser ce mécanisme pour imprimer des types de données personnalisés tels que vos classes.

D'accord, vous pouvez maintenant appelerprint() avec un seul argument ou sans aucun argument. Vous savez imprimer des messages fixes ou formatés sur l'écran. La prochaine sous-section développera un peu la mise en forme des messages.

Vous avez vuprint() appelé sans aucun argument pour produire une ligne vide, puis appelé avec un seul argument pour afficher un message fixe ou formaté.

Cependant, il s'avère que cette fonction peut accepter n'importe quel nombre depositional arguments, y compris zéro, un ou plusieurs arguments. C'est très pratique dans un cas courant de mise en forme des messages, où vous souhaitez associer quelques éléments.

Jetons un œil à cet exemple:

>>>

print() a concaténé les quatre arguments qui lui sont passés, et il a inséré un seul espace entre eux afin que vous ne vous retrouviez pas avec un message écrasé comme'My name isjdoeand I am42'.

Notez qu'il a également pris soin de la conversion de type appropriée en appelant implicitementstr() sur chaque argument avant de les joindre. Si vous vous souvenez de la sous-section précédente, une concaténation naïve peut facilement entraîner une erreur en raison de types incompatibles:

>>>

En plus d'accepter un nombre variable d'arguments positionnels,print() définit quatre nommés oukeyword arguments, qui sont facultatifs car ils ont tous des valeurs par défaut. Vous pouvez consulter leur brève documentation en appelanthelp(print) depuis l'interpréteur interactif.

Concentrons-nous sursep juste pour le moment. Il représenteseparator et se voit attribuer un seul espace (' ') par défaut. Il détermine la valeur avec laquelle joindre les éléments.

Il doit s'agir d'une chaîne ou deNone, mais ce dernier a le même effet que l'espace par défaut:

>>>

Si vous souhaitez supprimer complètement le séparateur, vous devez passer une chaîne vide ('') à la place:

>>>

Vous souhaiterez peut-être queprint() joint ses arguments sous forme de lignes séparées. Dans ce cas, passez simplement le caractère de nouvelle ligne échappé décrit précédemment:

>>>

Un exemple plus utile du paramètresep serait d'imprimer quelque chose comme les chemins de fichiers:

>>>

N'oubliez pas que le séparateur vient entre les éléments, pas autour d'eux, vous devez donc en tenir compte d'une manière ou d'une autre:

>>>

Plus précisément, vous pouvez insérer une barre oblique (/) dans le premier argument positionnel, ou utiliser une chaîne vide comme premier argument pour appliquer la barre oblique.

Note: Soyez prudent lorsque vous joignez des éléments d'une liste ou d'un tuple.

Si vous le faites manuellement, vous obtiendrez unTypeError bien connu si au moins un des éléments n’est pas une chaîne:

>>>

Il est plus sûr de simplement décompresser la séquence avec l’opérateur étoile (*) et de laisserprint() gérer le type de conversion:

>>>

Le déballage est en fait identique à l'appel deprint() avec des éléments individuels de la liste.

Un autre exemple intéressant pourrait être l'exportation de données au formatcomma-separated values (CSV):

>>>

Cela ne traiterait pas correctement les cas marginaux tels que les virgules d'échappement, mais pour les cas d'utilisation simples, il devrait le faire. La ligne ci-dessus apparaîtra dans votre fenêtre de terminal. Pour l'enregistrer dans un fichier, vous devez rediriger la sortie. Plus loin dans cette section, vous verrez comment utiliserprint() pour écrire du texte dans des fichiers directement à partir de Python.

Enfin, le paramètresep n'est pas limité à un seul caractère. Vous pouvez joindre des éléments avec des chaînes de n'importe quelle longueur:

>>>

Dans les sous-sections à venir, vous explorerez les arguments de mots clés restants de la fonctionprint().

Parfois, vous ne souhaitez pas terminer votre message par une nouvelle ligne de fin de sorte que les appels suivants àprint() se poursuivent sur la même ligne. Les exemples classiques incluent la mise à jour de la progression d'une opération de longue durée ou l'invitation de l'utilisateur à entrer. Dans ce dernier cas, vous souhaitez que l'utilisateur tape la réponse sur la même ligne:

De nombreux langages de programmation exposent des fonctions similaires àprint() via leurs bibliothèques standard, mais ils vous permettent de décider d'ajouter ou non une nouvelle ligne. Par exemple, en Java et C #, vous avez deux fonctions distinctes, tandis que d'autres langages vous obligent à ajouter explicitement à la fin d'une chaîne littérale.

Voici quelques exemples de syntaxe dans de tels langages:

En revanche, la fonctionprint() de Python ajoute toujours sans demander, car c'est ce que vous voulez dans la plupart des cas. Pour le désactiver, vous pouvez profiter d'un autre argument de mot-clé,end, qui dicte par quoi terminer la ligne.

En termes de sémantique, le paramètreend est presque identique à celui desep que vous avez vu précédemment:

Vous comprenez maintenant ce qui se passe sous le capot lorsque vous appelezprint() sans arguments. Comme vous ne fournissez aucun argument positionnel à la fonction, il n'y a rien à joindre, et donc le séparateur par défaut n'est pas du tout utilisé. Cependant, la valeur par défaut deend s'applique toujours et une ligne vide apparaît.

Note: Vous vous demandez peut-être pourquoi le paramètreend a une valeur par défaut fixe plutôt que ce qui a du sens sur votre système d'exploitation.

Eh bien, vous n’avez pas à vous soucier de la représentation de nouvelle ligne sur différents systèmes d’exploitation lors de l’impression, carprint() gérera automatiquement la conversion. N'oubliez pas de toujours utiliser la séquence d'échappement de dans les chaînes littérales.

C'est actuellement la façon la plus portable d'imprimer un caractère de nouvelle ligne en Python:

>>>

Si vous deviez essayer d'imprimer de force un caractère de nouvelle ligne spécifique à Windows sur une machine Linux, par exemple, vous vous retrouveriez avec une sortie cassée:

>>>

D'un autre côté, lorsque vous ouvrez un fichier en lecture avecopen(), vous n'avez pas non plus besoin de vous soucier de la représentation de nouvelle ligne. La fonction traduira toute nouvelle ligne spécifique au système rencontrée en un' ' universel. Dans le même temps, vous avez le contrôle sur la façon dont les sauts de ligne doivent être traités à la fois en entrée et en sortie si vous en avez vraiment besoin.

Pour désactiver la nouvelle ligne, vous devez spécifier une chaîne vide via l'argument de mot-cléend:

Même s'il s'agit de deux appelsprint() séparés, qui peuvent s'exécuter longtemps à part, vous ne verrez finalement qu'une seule ligne. Tout d'abord, cela ressemblera à ceci:

Cependant, après le deuxième appel àprint(), la même ligne apparaîtra à l'écran comme:

Comme avecsep, vous pouvez utiliserend pour joindre des éléments individuels en une grosse goutte de texte avec un séparateur personnalisé. Au lieu de joindre plusieurs arguments, cependant, il ajoutera le texte de chaque appel de fonction à la même ligne:

Ces trois instructions afficheront une seule ligne de texte:

Vous pouvez mélanger les deux arguments de mots clés:

Non seulement vous obtenez une seule ligne de texte, mais tous les éléments sont séparés par une virgule:

Rien ne vous empêche d'utiliser le caractère de nouvelle ligne avec un rembourrage supplémentaire autour:

Il imprimerait le texte suivant:

Comme vous pouvez le voir, l'argument de mot-cléend acceptera des chaînes arbitraires.

Note: Une boucle sur des lignes dans un fichier texte préserve leurs propres caractères de nouvelle ligne, ce qui, combiné avec le comportement par défaut de la fonctionprint(), entraînera un caractère de nouvelle ligne redondant:

>>>

Il y a deux nouvelles lignes après chaque ligne de texte. Vous souhaitez supprimer l'un d'eux, comme indiqué plus haut dans cet article, avant d'imprimer la ligne:

Vous pouvez également conserver la nouvelle ligne dans le contenu mais supprimer automatiquement celle ajoutée parprint(). Vous utiliserez l'argument de mot-cléend pour ce faire:

>>>

En terminant une ligne avec une chaîne vide, vous désactivez effectivement l'une des nouvelles lignes.

Vous vous familiarisez davantage avec l'impression en Python, mais il reste encore beaucoup d'informations utiles à venir. Dans la sous-section à venir, vous apprendrez comment intercepter et rediriger la sortie de la fonctionprint().

Croyez-le ou non,print() ne sait pas comment transformer des messages en texte sur votre écran, et franchement, ce n’est pas nécessaire. C'est un travail pour les couches de code de niveau inférieur, qui comprennent les octets et savent comment les déplacer.

print() est une abstraction sur ces couches, fournissant une interface pratique qui délègue simplement l'impression réelle à un flux ou àfile-like object. Un flux peut être n'importe quel fichier sur votre disque, une prise réseau ou peut-être un tampon en mémoire.

En plus de cela, il existe trois flux standard fournis par le système d'exploitation:

En Python, vous pouvez accéder à tous les flux standard via le module intégrésys:

>>>

Comme vous pouvez le voir, ces valeurs prédéfinies ressemblent à des objets de type fichier avec les attributsmode etencoding ainsi qu'aux méthodes.read() et.write() parmi beaucoup d'autres.

Par défaut,print() est lié àsys.stdout via son argumentfile, mais vous pouvez changer cela. Utilisez cet argument de mot-clé pour indiquer un fichier qui était ouvert en mode écriture ou ajout, afin que les messages y accèdent directement:

Cela rendra votre code à l'abri de la redirection de flux au niveau du système d'exploitation, ce qui pourrait ou non être souhaité.

Pour plus d'informations surworking with files in Python, vous pouvez consulterReading and Writing Files in Python (Guide).

Note: N'essayez pas d'utiliserprint() pour écrire des données binaires car il ne convient que pour le texte.

Appelez simplement les.write() du fichier binaire directement:

Si vous vouliez écrire des octets bruts sur la sortie standard, cela échouera également carsys.stdout est un flux de caractères:

>>>

Vous devez creuser plus profondément pour obtenir une poignée du flux d'octets sous-jacent à la place:

>>>

Cela imprime une lettre majusculeA et un caractère de nouvelle ligne, qui correspondent aux valeurs décimales de 65 et 10 en ASCII. Cependant, ils sont codés en utilisant la notation hexadécimale dans le littéral d'octets.

Notez queprint() n'a aucun contrôle surcharacter encoding. Il incombe au flux de coder correctement les chaînes Unicode reçues en octets. Dans la plupart des cas, vous ne définissez pas l'encodage vous-même, car l'UTF-8 par défaut est ce que vous voulez. Si vous en avez vraiment besoin, peut-être pour les systèmes hérités, vous pouvez utiliser l'argumentencoding deopen():

Au lieu d'un fichier réel existant quelque part dans votre système de fichiers, vous pouvez en fournir un faux, qui résiderait dans la mémoire de votre ordinateur. Vous utiliserez cette technique plus tard pour simulerprint() dans les tests unitaires:

>>>

Si vous en êtes arrivé là, il ne vous reste qu’un seul argument de mot-clé dansprint(), que vous verrez dans la sous-section suivante. C'est probablement le moins utilisé de tous. Néanmoins, il y a des moments où c'est absolument nécessaire.

Dans la sous-section précédente, vous avez appris queprint() délègue l'impression à un objet de type fichier tel quesys.stdout. Cependant, certains flux tamponnent certaines opérations d'E / S pour améliorer les performances, ce qui peut gêner. Voyons un exemple.

Imaginez que vous écriviez un compte à rebours, qui devrait ajouter le temps restant à la même ligne chaque seconde:

Votre première tentative peut ressembler à ceci:

Tant que la variablecountdown est supérieure à zéro, le code continue d'ajouter du texte sans une nouvelle ligne de fin, puis se met en veille pendant une seconde. Enfin, lorsque le compte à rebours est terminé, il imprimeGo! et termine la ligne.

De façon inattendue, au lieu de décompter chaque seconde, le programme tourne inutilement au ralenti pendant trois secondes, puis imprime soudainement la ligne entière à la fois:

C'est parce que le système d'exploitation met en mémoire tampon les écritures suivantes sur la sortie standard dans ce cas. Vous devez savoir qu'il existe trois types de flux en ce qui concerne la mise en mémoire tampon:

Unbuffered est explicite, c'est-à-dire qu'aucune mise en mémoire tampon n'a lieu et que toutes les écritures ont un effet immédiat. Un fluxline-buffered attend avant de déclencher des appels d'E / S jusqu'à ce qu'un saut de ligne apparaisse quelque part dans le tampon, alors qu'un fluxblock-buffered permet simplement au tampon de se remplir jusqu'à une certaine taille quel que soit son contenu. La sortie standard est à la foisline-buffered etblock-buffered, selon l'événement qui vient en premier.

La mise en mémoire tampon permet de réduire le nombre d'appels d'E / S coûteux. Pensez à envoyer des messages sur un réseau à latence élevée, par exemple. Lorsque vous vous connectez à un serveur distant pour exécuter des commandes via le protocole SSH, chacune de vos frappes peut en fait produire un paquet de données individuel, qui est de plusieurs ordres de grandeur plus grand que sa charge utile. Quel frais généraux! Il serait logique d'attendre qu'au moins quelques caractères soient saisis, puis de les envoyer ensemble. C’est là que la mise en mémoire tampon intervient.

D'un autre côté, la mise en mémoire tampon peut parfois avoir des effets indésirables comme vous venez de le voir avec l'exemple du compte à rebours. Pour résoudre ce problème, vous pouvez simplement dire àprint() de vider de force le flux sans attendre un caractère de nouvelle ligne dans le tampon en utilisant son indicateurflush:

C'est tout. Votre compte à rebours devrait fonctionner comme prévu maintenant, mais ne me croyez pas sur parole. Allez-y et testez-le pour voir la différence.

Toutes nos félicitations! À ce stade, vous avez vu des exemples d'appels deprint() qui couvrent tous ses paramètres. Vous connaissez leur objectif et quand les utiliser. Cependant, comprendre la signature n'est qu'un début. Dans les sections à venir, vous comprendrez pourquoi.

Jusqu'à présent, vous ne vous occupiez que des types de données intégrés tels que les chaînes et les nombres, mais vous souhaiterez souvent imprimer vos propres types de données abstraits. Voyons différentes façons de les définir.

Pour les objets simples sans aucune logique, dont le but est de transporter des données, vous profiterez généralement denamedtuple, qui est disponible dans la bibliothèque standard. Les tuples nommés ont une représentation textuelle soignée prête à l'emploi:

>>>

C’est bien tant que la conservation des données est suffisante, mais pour ajouter des comportements au typePerson, vous devrez éventuellement définir une classe. Jetez un œil à cet exemple:

Si vous créez maintenant une instance de la classePerson et essayez de l’imprimer, vous obtiendrez cette sortie bizarre, qui est assez différente de l’équivalentnamedtuple:

>>>

Il s'agit de la représentation par défaut des objets, qui comprend leur adresse en mémoire, le nom de classe correspondant et un module dans lequel ils ont été définis. Vous allez résoudre ce problème dans un instant, mais juste pour mémoire, comme solution de contournement rapide, vous pouvez combinernamedtuple et une classe personnalisée viainheritance:

Votre classePerson vient de devenir un type spécialisé denamedtuple avec deux attributs que vous pouvez personnaliser.

Note: En Python 3, l'instructionpass peut être remplacée par le littéralellipsis (...) pour indiquer un espace réservé:

Cela empêche l'interpréteur d'éleverIndentationError en raison d'un bloc de code indenté manquant.

C'est mieux qu'un simplenamedtuple, car non seulement vous obtenez une impression correcte gratuitement, mais vous pouvez également ajouter des méthodes et des propriétés personnalisées à la classe. Cependant, il résout un problème tout en en introduisant un autre. N'oubliez pas que les tuples, y compris les tuples nommés, sont immuables en Python, ils ne peuvent donc pas modifier leurs valeurs une fois créés.

Il est vrai que la conception de types de données immuables est souhaitable, mais dans de nombreux cas, vous souhaiterez qu’ils autorisent le changement, vous êtes donc de retour avec des classes régulières.

Note: Suite à d'autres langages et frameworks, Python 3.7 a introduitdata classes, que vous pouvez considérer comme des tuples mutables. De cette façon, vous obtenez le meilleur des deux mondes:

>>>

La syntaxe devariable annotations, qui est requise pour spécifier les champs de classe avec leurs types correspondants, a été définie dans Python 3.6.

Dans les sous-sections précédentes, vous savez déjà queprint() appelle implicitement la fonctionstr() intégrée pour convertir ses arguments de position en chaînes. En effet, appelerstr() manuellement sur une instance de la classe normalePerson donne le même résultat que de l'imprimer:

>>>

str(), à son tour, recherche l'un des deuxmagic methods dans le corps de la classe, que vous implémentez généralement. S'il n'en trouve pas, il revient à la représentation par défaut laide. Ces méthodes magiques sont, par ordre de recherche:

Le premier est recommandé de renvoyer un texte court et lisible par l'homme, qui comprend des informations sur les attributs les plus pertinents. Après tout, vous ne souhaitez pas exposer des données sensibles, telles que les mots de passe des utilisateurs, lors de l'impression d'objets.

Cependant, l'autre doit fournir des informations complètes sur un objet, pour permettre de restaurer son état à partir d'une chaîne. Idéalement, il devrait renvoyer du code Python valide, afin que vous puissiez le passer directement àeval():

>>>

Notez l’utilisation d’une autre fonction intégrée,repr(), qui essaie toujours d’appeler.__repr__() dans un objet, mais revient à la représentation par défaut s’il ne trouve pas cette méthode.

Note: Même siprint() lui-même utilisestr() pour la conversion de type, certains types de données composés délèguent cet appel àrepr() sur leurs membres. Cela arrive par exemple aux listes et aux tuples.

Considérez cette classe avec les deux méthodes magiques, qui renvoient des représentations de chaîne alternatives du même objet:

Si vous imprimez un seul objet de la classeUser, vous ne verrez pas le mot de passe, carprint(user) appellerastr(user), ce qui finira par appeleruser.__str__():

>>>

Cependant, si vous mettez la même variableuser dans une liste en la mettant entre crochets, le mot de passe deviendra clairement visible:

>>>

En effet, les séquences, telles que les listes et les tuples, implémentent leur méthode.__str__() afin que tous leurs éléments soient d'abord convertis avecrepr().

Python vous donne beaucoup de liberté lorsqu'il s'agit de définir vos propres types de données si aucun des types intégrés ne répond à vos besoins. Certains d'entre eux, tels que les tuples nommés et les classes de données, offrent des représentations de chaînes qui semblent bonnes sans nécessiter de travail de votre part. Néanmoins, pour plus de flexibilité, vous devrez définir une classe et remplacer ses méthodes magiques décrites ci-dessus.

Vous avez vu queprint() est une fonction en Python 3. Plus précisément, il s'agit d'une fonction intégrée, ce qui signifie que vous n'avez pas besoin de l'importer de n'importe où:

>>>

Il est toujours disponible dans l'espace de noms global pour que vous puissiez l'appeler directement, mais vous pouvez également y accéder via un module à partir de la bibliothèque standard:

>>>

De cette façon, vous pouvez éviter les collisions de noms avec des fonctions personnalisées. Supposons que vous vouliezredefineprint() pour qu'il n'ajoute pas de nouvelle ligne à la fin. En même temps, vous vouliez renommer la fonction d'origine en quelque chose commeprintln():

>>>

Vous disposez maintenant de deux fonctions d'impression distinctes, tout comme dans le langage de programmation Java. Vous définirez également les fonctionsprint() personnalisées dans lesmocking section ultérieurement. Notez également que vous ne pourrez pas écraserprint() en premier lieu s'il ne s'agissait pas d'une fonction.

D'un autre côté,print() n'est pas une fonction au sens mathématique, car il ne renvoie aucune valeur significative autre que lesNone implicites:

>>>

De telles fonctions sont, en fait, des procédures ou des sous-programmes que vous appelez pour obtenir une sorte d'effet secondaire, qui est finalement un changement d'état global. Dans le cas deprint(), cet effet secondaire affiche un message sur la sortie standard ou écrit dans un fichier.

Puisqueprint() est une fonction, elle a une signature bien définie avec des attributs connus. Vous pouvez trouver rapidement sesdocumentation en utilisant l'éditeur de votre choix, sans avoir à vous souvenir d'une syntaxe étrange pour effectuer une certaine tâche.

De plus, les fonctions sont plus faciles pourextend. L'ajout d'une nouvelle fonctionnalité à une fonction est aussi simple que l'ajout d'un autre argument de mot clé, tandis que changer la langue pour prendre en charge cette nouvelle fonctionnalité est beaucoup plus lourd. Pensez à la redirection de flux ou au vidage de tampon, par exemple.

Un autre avantage deprint() étant une fonction estcomposability. Les fonctions sont appeléesfirst-class objects oufirst-class citizens en Python, ce qui est une manière sophistiquée de dire que ce sont des valeurs comme des chaînes ou des nombres. De cette façon, vous pouvez affecter une fonction à une variable, la transmettre à une autre fonction ou même la renvoyer l'une à l'autre. print() n'est pas différent à cet égard. Par exemple, vous pouvez en profiter pour l'injection de dépendances:

Ici, le paramètrelog vous permet d'injecter une fonction de rappel, qui par défaut estprint() mais peut être n'importe quel appelable. Dans cet exemple, l'impression est complètement désactivée en remplaçantprint() par une fonction factice qui ne fait rien.

Note: Undependency est tout morceau de code requis par un autre bit de code.

Dependency injection est une technique utilisée dans la conception de code pour le rendre plus testable, réutilisable et ouvert à l'extension. Vous pouvez y parvenir en faisant référence aux dépendances indirectement via des interfaces abstraites et en les fournissant de manièrepush plutôt quepull.

Il y a une explication amusante de l'injection de dépendance circulant sur Internet:

La composition vous permet de combiner quelques fonctions en une nouvelle du même type. Voyons cela en action en spécifiant une fonctionerror() personnalisée qui imprime dans le flux d'erreur standard et préfixe tous les messages avec un niveau de journal donné:

>>>

Cette fonction personnalisée utilisepartial functions pour obtenir l'effet souhaité. Il s'agit d'un concept avancé emprunté au paradigmefunctional programming, vous n'avez donc pas besoin d'aller trop loin dans ce sujet pour le moment. Cependant, si vous êtes intéressé par ce sujet, je vous recommande de jeter un œil au modulefunctools.

Contrairement aux instructions, les fonctions sont des valeurs. Cela signifie que vous pouvez les mélanger avecexpressions, en particulier,lambda expressions. Au lieu de définir une fonction complète pour remplacerprint() par, vous pouvez créer une expression lambda anonyme qui l'appelle:

>>>

Cependant, comme une expression lambda est définie sur place, il n'y a aucun moyen de s'y référer ailleurs dans le code.

Note: En Python, vous ne pouvez pas placer d'instructions, telles que des affectations, des instructions conditionnelles, des boucles, etc., dans unanonymous lambda function. Ce doit être une seule expression!

Un autre type d'expression est une expression conditionnelle ternaire:

>>>

Python a à la foisconditional statements etconditional expressions. Ce dernier est évalué en une valeur unique qui peut être affectée à une variable ou passée à une fonction. Dans l'exemple ci-dessus, vous êtes intéressé par l'effet secondaire plutôt que par la valeur, qui équivaut àNone, donc vous l'ignorez simplement.

Comme vous pouvez le voir, les fonctions permettent une solution élégante et extensible, cohérente avec le reste du langage. Dans la sous-section suivante, vous découvrirez comment le fait de ne pas avoirprint() en tant que fonction a causé beaucoup de maux de tête.

Unstatement est une instruction qui peut évoquer un effet secondaire lors de son exécution mais qui ne s'évalue jamais à une valeur. En d'autres termes, vous ne pourriez pas imprimer une instruction ou l'attribuer à une variable comme celle-ci:

C'est une erreur de syntaxe dans Python 2.

Voici quelques autres exemples d'instructions en Python:

Note: Python 3.8 apporte unwalrus operator (:=) controversé, qui est unassignment expression. Avec lui, vous pouvez évaluer une expression et affecter le résultat à une variable en même temps, même dans une autre expression!

Jetez un œil à cet exemple, qui appelle une fois une fonction coûteuse, puis réutilise le résultat pour un calcul ultérieur:

Ceci est utile pour simplifier le code sans perdre son efficacité. En règle générale, le code performant a tendance à être plus détaillé:

La controverse derrière ce nouveau morceau de syntaxe a provoqué beaucoup d'arguments. Une abondance de commentaires négatifs et de débats passionnés a finalement conduit Guido van Rossum à se retirer de la positionBenevolent Dictator For Life ou BDFL.

Les instructions sont généralement composées de mots-clés réservés tels queif,for ouprint qui ont une signification fixe dans la langue. Vous ne pouvez pas les utiliser pour nommer vos variables ou autres symboles. C'est pourquoi il n'est pas possible de redéfinir ou de se moquer de l'instructionprint dans Python 2. Vous êtes coincé avec ce que vous obtenez.

De plus, vous ne pouvez pas imprimer à partir de fonctions anonymes, car les instructions ne sont pas acceptées dans les expressions lambda:

>>>

La syntaxe de l'instructionprint est ambiguë. Parfois, vous pouvez ajouter des parenthèses autour du message, et elles sont complètement facultatives:

>>>

À d'autres moments, ils modifient la façon dont le message est imprimé:

>>>

La concaténation de chaînes peut augmenter unTypeError en raison de types incompatibles, que vous devez gérer manuellement, par exemple:

>>>

Comparez cela avec un code similaire dans Python 3, qui exploite le décompression de séquence:

>>>

Il n’existe aucun argument de mot clé pour les tâches courantes telles que le vidage du tampon ou la redirection de flux. Vous devez vous souvenir de la syntaxe excentrique à la place. Même la fonction intégréehelp() n’est pas si utile en ce qui concerne l’instructionprint:

>>>

La suppression de la nouvelle ligne ne fonctionne pas correctement, car elle ajoute un espace indésirable. Vous ne pouvez pas composer plusieurs instructionsprint ensemble, et, en plus de cela, vous devez être très diligent sur le codage des caractères.

La liste des problèmes s'allonge encore et encore. Si vous êtes curieux, vous pouvez revenir auxprevious section et rechercher des explications plus détaillées sur la syntaxe de Python 2.

Cependant, vous pouvez atténuer certains de ces problèmes avec une approche beaucoup plus simple. Il s'avère que la fonctionprint() a été rétroportée pour faciliter la migration vers Python 3. Vous pouvez l'importer à partir d'un module spécial__future__, qui expose une sélection de fonctionnalités de langage publiées dans les versions ultérieures de Python.

Note: Vous pouvez importer des fonctions futures ainsi que des constructions de langage intégrées telles que l'instructionwith.

Pour savoir exactement quelles fonctionnalités sont à votre disposition, inspectez le module:

>>>

Vous pouvez également appelerdir(__future__), mais cela montrerait beaucoup de détails internes inintéressants du module.

Pour activer la fonctionprint() dans Python 2, vous devez ajouter cette instruction d'importation au début de votre code source:

Désormais, l'instructionprint n'est plus disponible, mais vous avez la fonctionprint() à votre disposition. Notez qu'il ne s'agit pas de la même fonction que celle de Python 3, car il manque l'argument de mot-cléflush, mais le reste des arguments sont les mêmes.

À part cela, cela ne vous évite pas de gérer correctement les encodages de caractères.

Voici un exemple d’appel de la fonctionprint() dans Python 2:

>>>

Vous avez maintenant une idée de l'évolution de l'impression en Python et, plus important encore, vous comprenez pourquoi ces changements incompatibles en amont étaient nécessaires. Le savoir vous aidera sûrement à devenir un meilleur programmeur Python.

Les langages informatiques vous permettent de représenter des données ainsi que du code exécutable de manière structurée. Contrairement à Python, cependant, la plupart des langues vous offrent une grande liberté dans l'utilisation des espaces et du formatage. Cela peut être utile, par exemple en compression, mais cela conduit parfois à un code moins lisible.

La jolie impression consiste à rendre une donnée ou un code plus attrayant pour l'œil humain afin de le comprendre plus facilement. Pour ce faire, indenter certaines lignes, insérer des nouvelles lignes, réorganiser les éléments, etc.

Python est livré avec le modulepprint dans sa bibliothèque standard, ce qui vous aidera à imprimer de jolies structures de données volumineuses qui ne tiennent pas sur une seule ligne. Parce qu'il imprime de manière plus conviviale, de nombreux outilsREPL populaires, y comprisJupyterLab and IPython, l'utilisent par défaut à la place de la fonction normaleprint().

Note: Pour activer la jolie impression dans IPython, exécutez la commande suivante:

>>>

Ceci est un exemple deMagic dans IPython. Il existe de nombreuses commandes intégrées qui commencent par un signe de pourcentage (%), mais vous pouvez en trouver plus surPyPI, ou même créer les vôtres.

Si vous ne vous souciez pas de ne pas avoir accès à la fonction d'origineprint(), vous pouvez la remplacer parpprint() dans votre code en utilisant le changement de nom d'importation:

>>>

Personnellement, j'aime avoir les deux fonctions à portée de main, donc je préfère utiliser quelque chose commepp comme alias court:

À première vue, il n'y a pratiquement pas de différence entre les deux fonctions, et dans certains cas, il n'y en a pratiquement aucune:

>>>

C'est parce quepprint() appellerepr() au lieu desstr() habituels pour la conversion de type, de sorte que vous pouvez évaluer sa sortie en tant que code Python si vous le souhaitez. Les différences deviennent apparentes lorsque vous commencez à lui fournir des structures de données plus complexes:

>>>

La fonction applique une mise en forme raisonnable pour améliorer la lisibilité, mais vous pouvez la personnaliser encore plus avec quelques paramètres. Par exemple, vous pouvez limiter une hiérarchie profondément imbriquée en affichant des points de suspension sous un niveau donné:

>>>

Lesprint() ordinaires utilisent également des ellipses, mais pour afficher des structures de données récursives, qui forment un cycle, afin d'éviter une erreur de débordement de pile:

>>>

Cependant,pprint() est plus explicite à ce sujet en incluant l'identité unique d'un objet auto-référencé:

>>>

Le dernier élément de la liste est le même objet que la liste entière.

Note: Les ensembles de données récursifs ou très volumineux peuvent également être traités en utilisant le modulereprlib:

>>>

Ce module prend en charge la plupart des types intégrés et est utilisé par le débogueur Python.

pprint() trie automatiquement les clés du dictionnaire pour vous avant l'impression, ce qui permet une comparaison cohérente. Lorsque vous comparez des chaînes, vous ne vous souciez souvent pas d'un ordre particulier d'attributs sérialisés. Quoi qu'il en soit, il est toujours préférable de comparer les dictionnaires réels avant la sérialisation.

Les dictionnaires représentent souventJSON data, qui est largement utilisé sur Internet. Pour sérialiser correctement un dictionnaire dans une chaîne au format JSON valide, vous pouvez tirer parti du modulejson. Il a également de jolies capacités d'impression:

>>>

Notez cependant que vous devez gérer l'impression vous-même, car ce n'est pas quelque chose que vous souhaitez généralement faire. De même, le modulepprint a une fonctionpformat() supplémentaire qui renvoie une chaîne, au cas où vous auriez à faire autre chose que de l'imprimer.

Étonnamment, la signature depprint() ne ressemble en rien à celle de la fonctionprint(). Vous ne pouvez même pas passer plus d'un argument positionnel, ce qui montre à quel point il se concentre sur l'impression des structures de données.

À mesure que les ordinateurs personnels devenaient plus sophistiqués, ils avaient de meilleurs graphismes et pouvaient afficher plus de couleurs. Cependant, différents fournisseurs avaient leur propre idée de la conception de l'API pour la contrôler. Cela a changé il y a quelques décennies lorsque les gens de l'American National Standards Institute ont décidé de l'unifier en définissantANSI escape codes.

La plupart des émulateurs de terminaux d'aujourd'hui prennent en charge cette norme dans une certaine mesure. Jusqu'à récemment, le système d'exploitation Windows était une exception notable. Par conséquent, si vous voulez la meilleure portabilité, utilisez la bibliothèquecolorama en Python. Il traduit les codes ANSI à leurs homologues appropriés dans Windows tout en les conservant intacts dans d'autres systèmes d'exploitation.

Pour vérifier si votre terminal comprend un sous-ensemble des séquences d'échappement ANSI, par exemple, liées aux couleurs, vous pouvez essayer d'utiliser la commande suivante:

Mon terminal par défaut sur Linux dit qu'il peut afficher 256 couleurs distinctes, tandis que xterm m'en donne seulement 8. La commande retournerait un nombre négatif si les couleurs n'étaient pas prises en charge.

Les séquences d'échappement ANSI sont comme un langage de balisage pour le terminal. En HTML, vous travaillez avec des balises, telles que<b> ou<i>, pour modifier l'apparence des éléments dans le document. Ces balises sont mélangées à votre contenu, mais elles ne sont pas visibles elles-mêmes. De même, les codes d'échappement ne s'affichent pas dans le terminal tant qu'il les reconnaît. Sinon, ils apparaîtront sous la forme littérale comme si vous consultiez la source d'un site Web.

Comme son nom l'indique, une séquence doit commencer par le caractère non imprimable[.kbd .key-escape]#Esc #, dont la valeur ASCII est 27, parfois désigné par0x1b en hexadécimal ou033 en octal. Vous pouvez utiliser des littéraux numériques Python pour vérifier rapidement qu'il s'agit bien du même numéro:

>>>

De plus, vous pouvez l'obtenir avec la séquence d'échappement\e dans le shell:

Les séquences d'échappement ANSI les plus courantes prennent la forme suivante:

Lesnumeric code peuvent être un ou plusieurs nombres séparés par un point-virgule, tandis que lescharacter code ne sont qu'une lettre. Leur signification spécifique est définie par la norme ANSI. Par exemple, pour réinitialiser tout le formatage, vous devez taper l'une des commandes suivantes, qui utilisent le code zéro et la lettrem:

À l'autre extrémité du spectre, vous avez des valeurs de code composées. Pour définir l'avant-plan et l'arrière-plan avec des canaux RVB, étant donné que votre terminal prend en charge une profondeur de 24 bits, vous pouvez fournir plusieurs nombres:

Ce n'est pas seulement la couleur du texte que vous pouvez définir avec les codes d'échappement ANSI. Vous pouvez, par exemple, effacer et faire défiler la fenêtre du terminal, modifier son arrière-plan, déplacer le curseur, faire clignoter le texte ou le décorer avec un soulignement.

En Python, vous écririez probablement une fonction d'assistance pour permettre d'encapsuler des codes arbitraires dans une séquence:

>>>

Cela ferait apparaître le motreally dans une police rouge, grasse et soulignée:

Cependant, il existe des abstractions de plus haut niveau sur les codes d'échappement ANSI, comme la bibliothèquecolorama mentionnée, ainsi que des outils pour créer des interfaces utilisateur dans la console.

Bien que jouer avec les codes d'échappement ANSI soit indéniablement très amusant, dans le monde réel, vous préférez avoir des blocs de construction plus abstraits pour créer une interface utilisateur. Il existe quelques bibliothèques qui offrent un niveau de contrôle aussi élevé sur le terminal, maiscurses semble être le choix le plus populaire.

Note: Pour utiliser la bibliothèquecurses sous Windows, vous devez installer un package tiers:

C'est parce quecurses n'est pas disponible dans la bibliothèque standard de la distribution Python pour Windows.

Principalement, il vous permet de penser en termes de widgets graphiques indépendants au lieu d'une goutte de texte. De plus, vous avez beaucoup de liberté pour exprimer votre artiste intérieur, car c'est vraiment comme peindre une toile vierge. La bibliothèque cache la complexité d'avoir à traiter avec différents terminaux. En dehors de cela, il prend en charge les événements de clavier, ce qui pourrait être utile pour écrire des jeux vidéo.

Que diriez-vous de faire un jeu de serpent rétro? Créons un simulateur de serpent Python:

Tout d'abord, vous devez importer le modulecurses. Puisqu'il modifie l'état d'un terminal en cours d'exécution, il est important de gérer les erreurs et de restaurer gracieusement l'état précédent. Vous pouvez le faire manuellement, mais la bibliothèque est livrée avec un wrapper pratique pour votre fonction principale:

Notez que la fonction doit accepter une référence à l’objet écran, également appeléstdscr, que vous utiliserez plus tard pour une configuration supplémentaire.

Si vous exécutez ce programme maintenant, vous ne verrez aucun effet, car il se termine immédiatement. Cependant, vous pouvez ajouter un petit délai pour avoir un aperçu:

Cette fois, l'écran est devenu complètement vide pendant une seconde, mais le curseur clignotait toujours. Pour le masquer, il suffit d'appeler l'une des fonctions de configuration définies dans le module:

Définissons le serpent comme une liste de points en coordonnées d'écran:

La tête du serpent est toujours le premier élément de la liste, tandis que la queue est le dernier. La forme initiale du serpent est horizontale, partant du coin supérieur gauche de l'écran et orientée vers la droite. Alors que sa coordonnée y reste à zéro, sa coordonnée x diminue de la tête à la queue.

Pour dessiner le serpent, vous commencerez par la tête, puis suivrez avec les segments restants. Chaque segment porte les coordonnées(y, x), vous pouvez donc les décompresser:

Encore une fois, si vous exécutez ce code maintenant, il n'affichera rien, car vous devez explicitement actualiser l'écran par la suite:

Vous souhaitez déplacer le serpent dans l'une des quatre directions, qui peuvent être définies comme des vecteurs. Finalement, la direction changera en réponse à une touche fléchée, vous pouvez donc la raccorder aux codes clés de la bibliothèque:

Comment se déplace un serpent? Il s'avère que seule sa tête se déplace réellement vers un nouvel emplacement, tandis que tous les autres segments se déplacent vers elle. À chaque étape, presque tous les segments restent les mêmes, à l'exception de la tête et de la queue. En supposant que le serpent ne grandit pas, vous pouvez retirer la queue et insérer une nouvelle tête au début de la liste:

Pour obtenir les nouvelles coordonnées de la tête, vous devez lui ajouter le vecteur de direction. Cependant, l'ajout de tuples en Python entraîne un plus grand tuple au lieu de la somme algébrique des composantes vectorielles correspondantes. Une façon de résoudre ce problème consiste à utiliser les fonctions intégréeszip(),sum() etmap().

La direction changera en appuyant sur une touche, vous devez donc appeler.getch() pour obtenir le code de la touche enfoncée. Cependant, si la touche enfoncée ne correspond pas aux touches fléchées définies précédemment comme touches de dictionnaire, la direction ne changera pas:

Par défaut, cependant,.getch() est un appel bloquant qui empêcherait le serpent de bouger à moins qu'il y ait une frappe. Par conséquent, vous devez rendre l'appel non bloquant en ajoutant une autre configuration:

Vous avez presque terminé, mais il ne reste qu’une dernière chose. Si vous bouclez maintenant ce code, le serpent semblera grandir au lieu de se déplacer. C'est parce que vous devez effacer l'écran explicitement avant chaque itération.

Enfin, c'est tout ce dont vous avez besoin pour jouer au jeu de serpent en Python:

Ceci ne fait qu'effleurer la surface des possibilités qu'ouvre le modulecurses. Vous pouvez l'utiliser pour le développement de jeux comme celui-ci ou pour des applications plus commerciales.

Les animations peuvent non seulement rendre l'interface utilisateur plus attrayante pour les yeux, mais elles améliorent également l'expérience utilisateur globale. Lorsque vous fournissez des commentaires précoces à l'utilisateur, par exemple, il saura si votre programme fonctionne toujours ou s'il est temps de le supprimer.

Pour animer du texte dans le terminal, vous devez pouvoir déplacer librement le curseur. Vous pouvez le faire avec l'un des outils mentionnés précédemment, à savoir les codes d'échappement ANSI ou la bibliothèquecurses. Cependant, je voudrais vous montrer une manière encore plus simple.

Si l'animation peut être limitée à une seule ligne de texte, vous pourriez être intéressé par deux séquences de caractères d'échappement spéciales:

Le premier déplace le curseur au début de la ligne, tandis que le second déplace un seul caractère vers la gauche. Ils fonctionnent tous les deux de manière non destructrice sans écraser le texte déjà écrit.

Jetons un œil à quelques exemples.

Vous souhaiterez souvent afficher une sorte despinning wheel pour indiquer un travail en cours sans savoir exactement combien de temps il reste à terminer:

De nombreux outils de ligne de commande utilisent cette astuce lors du téléchargement de données sur le réseau. Vous pouvez créer une animation stop motion vraiment simple à partir d'une séquence de caractères qui se déroulera de manière circulaire:

La boucle obtient le caractère suivant à imprimer, puis déplace le curseur au début de la ligne et écrase tout ce qu'il y avait avant sans ajouter de nouvelle ligne. Vous ne voulez pas d'espace supplémentaire entre les arguments positionnels, donc l'argument séparateur doit être vide. Notez également l'utilisation des chaînes brutes de Python en raison des caractères de barre oblique inverse présents dans le littéral.

Lorsque vous connaissez le temps restant ou le pourcentage d’achèvement des tâches, vous pouvez afficher une barre de progression animée:

Tout d'abord, vous devez calculer le nombre de hashtags à afficher et le nombre d'espaces vides à insérer. Ensuite, vous effacez la ligne et créez la barre à partir de zéro:

Comme précédemment, chaque demande de mise à jour repeint la ligne entière.

Note: Il existe une bibliothèqueprogressbar2 riche en fonctionnalités, ainsi que quelques autres outils similaires, qui peuvent montrer les progrès de manière beaucoup plus complète.

Si vous êtes assez vieux pour vous souvenir des ordinateurs équipés d'un haut-parleur de PC, vous devez également vous souvenir de leur sonbeep distinctif, souvent utilisé pour indiquer des problèmes matériels. Ils pouvaient à peine faire plus de bruit que ça, mais les jeux vidéo semblaient tellement mieux avec ça.

Aujourd'hui, vous pouvez toujours profiter de ce petit haut-parleur, mais il est probable que votre ordinateur portable n'en soit pas équipé. Dans un tel cas, vous pouvez activer l'émulationterminal bell dans votre shell, de sorte qu'un son d'avertissement système soit émis à la place.

Allez-y et tapez cette commande pour voir si votre terminal peut jouer un son:

Cela afficherait normalement du texte, mais l'indicateur-e permet l'interprétation des échappements de barre oblique inverse. Comme vous pouvez le voir, il existe une séquence d'échappement dédiée, qui signifie «alerte», qui génère unbell character spécial. Certains terminaux émettent un son chaque fois qu'ils le voient.

De même, vous pouvez imprimer ce caractère en Python. Peut-être en boucle pour former une sorte de mélodie. Bien qu'il ne s'agisse que d'une seule note, vous pouvez toujours faire varier la durée des pauses entre des instances consécutives. Cela semble être un jouet parfait pour la lecture du code Morse!

Les règles sont les suivantes:

Selon ces règles, vous pouvez «imprimer» un signal SOS indéfiniment de la manière suivante:

En Python, vous pouvez l'implémenter en seulement dix lignes de code:

Peut-être pourriez-vous même aller plus loin et créer un outil en ligne de commande pour traduire du texte en code Morse? Quoi qu'il en soit, j'espère que vous vous amusez avec ça!

Également appeléprint debugging oucaveman debugging, il s'agit de la forme de débogage la plus élémentaire. Bien qu'un peu démodé, il est toujours puissant et a ses utilisations.

L'idée est de suivre le chemin de l'exécution du programme jusqu'à ce qu'il s'arrête brusquement, ou donne des résultats incorrects, pour identifier l'instruction exacte avec un problème. Pour ce faire, vous insérez des déclarations imprimées avec des mots qui se détachent dans des endroits soigneusement choisis.

Jetez un œil à cet exemple, qui manifeste une erreur d'arrondi:

>>>

Comme vous pouvez le voir, la fonction ne renvoie pas la valeur attendue de0.1, mais vous savez maintenant que c'est parce que la somme est un peu décalée. Le suivi de l'état des variables à différentes étapes de l'algorithme peut vous donner une indication de l'emplacement du problème.

Cette méthode est simple et intuitive et fonctionnera dans à peu près tous les langages de programmation. Sans oublier, c'est un excellent exercice dans le processus d'apprentissage.

D'un autre côté, une fois que vous maîtrisez des techniques plus avancées, il est difficile de revenir en arrière, car elles vous permettent de trouver les bogues beaucoup plus rapidement. Le traçage est un processus manuel laborieux, qui peut laisser passer encore plus d'erreurs. Le cycle de génération et de déploiement prend du temps. Ensuite, vous devez vous rappeler de supprimer méticuleusement tous les appelsprint() que vous avez passés sans toucher accidentellement les appels authentiques.

En outre, cela vous oblige à apporter des modifications au code, ce qui n'est pas toujours possible. Vous êtes peut-être en train de déboguer une application exécutée sur un serveur Web distant ou souhaitez diagnostiquer un problème de manièrepost-mortem. Parfois, vous n'avez tout simplement pas accès à la sortie standard.

C’est précisément là quelogging brille.

Imaginons un instant que vous gérez un site Web de commerce électronique. Un jour, un client en colère passe un appel téléphonique pour se plaindre d'une transaction échouée et pour dire qu'il a perdu son argent. Il prétend avoir essayé d'acheter quelques articles, mais à la fin, une erreur cryptique l'a empêché de terminer cette commande. Pourtant, quand il a vérifié son compte bancaire, l'argent avait disparu.

Vous vous excusez sincèrement et effectuez un remboursement, mais vous ne voulez pas non plus que cela se reproduise à l'avenir. Comment déboguez-vous cela? Si seulement vous aviez une trace de ce qui s'est passé, idéalement sous la forme d'une liste chronologique des événements avec leur contexte.

Chaque fois que vous vous trouvez en train de faire du débogage d'impression, envisagez de le transformer en messages de journal permanents. Cela peut être utile dans des situations comme celle-ci, lorsque vous devez analyser un problème après qu'il s'est produit, dans un environnement auquel vous n'avez pas accès.

Il existe des outils sophistiqués pour l'agrégation et la recherche de journaux, mais au niveau le plus élémentaire, vous pouvez considérer les journaux comme des fichiers texte. Chaque ligne transmet des informations détaillées sur un événement dans votre système. Habituellement, il ne contient pas d'informations d'identification personnelle, bien que, dans certains cas, il puisse être mandaté par la loi.

Voici une ventilation d'un enregistrement de journal typique:

Comme vous pouvez le voir, il a une forme structurée. Outre un message descriptif, il existe quelques champs personnalisables, qui fournissent le contexte d'un événement. Ici, vous avez la date et l'heure exactes, le niveau de journal, le nom de l'enregistreur et le nom du thread.

Les niveaux de journalisation vous permettent de filtrer rapidement les messages pour réduire le bruit. Si vous recherchez une erreur, vous ne voulez pas voir tous les avertissements ou messages de débogage, par exemple. Il est trivial de désactiver ou d'activer des messages à certains niveaux de journal via la configuration, sans même toucher au code.

Avec la journalisation, vous pouvez garder vos messages de débogage séparés de la sortie standard. Tous les messages de journal sont envoyés par défaut au flux d'erreurs standard, qui peut facilement apparaître dans différentes couleurs. Cependant, vous pouvez rediriger les messages du journal vers des fichiers séparés, même pour des modules individuels!

Très souvent, une journalisation mal configurée peut entraîner un manque d’espace sur le disque du serveur. Pour éviter cela, vous pouvez configurerlog rotation, qui conservera les fichiers journaux pendant une durée spécifiée, telle qu'une semaine, ou une fois qu'ils auront atteint une certaine taille. Néanmoins, il est toujours recommandé d'archiver les journaux plus anciens. Certaines réglementations imposent que les données des clients soient conservées pendant cinq ans!

Comparé à d'autres langages de programmation,logging in Python est plus simple, car le modulelogging est fourni avec la bibliothèque standard. Vous venez de l'importer et de le configurer en seulement deux lignes de code:

Vous pouvez appeler des fonctions définies au niveau du module, qui sont accrochées auxroot logger, mais plus la pratique courante est d'obtenir un enregistreur dédié pour chacun de vos fichiers source:

L'avantage d'utiliser des enregistreurs personnalisés est un contrôle plus fin. Ils sont généralement nommés d'après le module dans lequel ils ont été définis via la variable__name__.

Note: Il existe un modulewarnings quelque peu lié en Python, qui peut également enregistrer les messages dans le flux d'erreur standard. Cependant, son spectre d'applications est plus restreint, principalement en code de bibliothèque, alors que les applications clientes devraient utiliser le modulelogging.

Cela dit, vous pouvez les faire fonctionner ensemble en appelantlogging.captureWarnings(True).

Une dernière raison pour passer de la fonctionprint() à la journalisation est la sécurité des threads. Dans la section à venir, vous verrez que le premier ne fonctionne pas bien avec plusieurs threads d'exécution.

La vérité est que ni le traçage ni la journalisation ne peuvent être considérés comme un véritable débogage. Pour effectuer le débogage réel, vous avez besoin d'un outil de débogage, qui vous permet d'effectuer les opérations suivantes:

Un débogueur grossier qui s'exécute dans le terminal, nommé sans surprisepdb pour «Le débogueur Python», est distribué dans le cadre de la bibliothèque standard. Cela le rend toujours disponible, il peut donc être votre seul choix pour effectuer le débogage à distance. C'est peut-être une bonne raison de s'y familiariser.

Cependant, il ne vient pas avec une interface graphique, doncusing pdb peut être un peu délicat. Si vous ne pouvez pas modifier le code, vous devez l'exécuter en tant que module et transmettre l'emplacement de votre script:

Sinon, vous pouvez configurer un point d'arrêt directement dans le code, ce qui suspendra l'exécution de votre script et vous déposera dans le débogueur. L'ancienne façon de procéder exigeait deux étapes:

>>>

Cela affiche une invite interactive, qui peut sembler intimidante au premier abord. Cependant, vous pouvez toujours taper Python natif à ce stade pour examiner ou modifier l'état des variables locales. En dehors de cela, il n'y a vraiment qu'une poignée de commandes spécifiques au débogueur que vous souhaitez utiliser pour parcourir le code.

Note: Il est habituel de placer les deux instructions pour lancer un débogueur sur une seule ligne. Cela nécessite l'utilisation d'un point-virgule, que l'on trouve rarement dans les programmes Python:

Bien qu'il ne s'agisse certainement pas de Pythonic, il s'agit d'un rappel pour le supprimer une fois le débogage terminé.

Depuis Python 3.7, vous pouvez également appeler la fonction intégréebreakpoint(), qui fait la même chose, mais de manière plus compacte et avec quelquesbells and whistles supplémentaires:

Vous allez probablement utiliser un débogueur visuel intégré à un éditeur de code pour la plupart. PyCharm possède un excellent débogueur, qui offre des performances élevées, mais vous trouverezplenty of alternative IDEs avec des débogueurs, à la fois payants et gratuits.

Le débogage n'est pas la solution miracle proverbiale. Parfois, la journalisation ou le traçage sera une meilleure solution. Par exemple, les défauts difficiles à reproduire, tels querace conditions, résultent souvent d'un couplage temporel. Lorsque vous vous arrêtez à un point d'arrêt, cette petite pause dans l'exécution du programme peut masquer le problème. C'est un peu comme lesHeisenberg principle: vous ne pouvez pas mesurer et observer un bogue en même temps.

Ces méthodes ne s'excluent pas mutuellement. Ils se complètent.

Python est livré avec une fonction intégrée pour accepter les entrées de l'utilisateur, appelée de manière prévisibleinput(). Il accepte les données du flux d'entrée standard, qui est généralement le clavier:

>>>

La fonction renvoie toujours une chaîne, vous devrez donc peut-être l'analyser en conséquence:

Le paramètre prompt est complètement facultatif, donc rien ne s'affichera si vous le sautez, mais la fonction fonctionnera toujours:

>>>

Néanmoins, lancer un appel à l'action descriptif rend l'expérience utilisateur bien meilleure.

Note: Pour lire à partir de l'entrée standard de Python 2, vous devez appelerraw_input() à la place, ce qui est encore un autre élément intégré. Malheureusement, il existe également une fonctioninput() mal nommée, qui fait une chose légèrement différente.

En fait, il prend également l'entrée du flux standard, mais il essaie ensuite de l'évaluer comme s'il s'agissait de code Python. Comme c'est un potentielsecurity vulnerability, cette fonction a été complètement supprimée de Python 3, tandis queraw_input() a été renommé eninput().

Voici une comparaison rapide des fonctions disponibles et de leurs fonctions:

Comme vous pouvez le constater, il est toujours possible de simuler l'ancien comportement dans Python 3.

Demander à l'utilisateur un mot de passe avecinput() est une mauvaise idée car il apparaîtra en texte brut au fur et à mesure qu'il le saisit. Dans ce cas, vous devriez utiliser la fonctiongetpass() à la place, qui masque les caractères tapés. Cette fonction est définie dans un module du même nom, également disponible dans la bibliothèque standard:

>>>

Le modulegetpass a une autre fonction pour obtenir le nom de l’utilisateur à partir d’une variable d’environnement:

>>>

Les fonctions intégrées de Python pour gérer l'entrée standard sont assez limitées. Dans le même temps, il existe de nombreux packages tiers, qui offrent des outils beaucoup plus sophistiqués.

Il existe des packages Python externes qui permettent de créer des interfaces graphiques complexes spécifiquement pour collecter des données auprès de l'utilisateur. Certaines de leurs fonctionnalités incluent:

La démonstration de tels outils n'entre pas dans le cadre de cet article, mais vous pouvez les essayer. J'ai personnellement appris à connaître certains d'entre eux grâce auxPython Bytes Podcast. Les voici:

Néanmoins, il convient de mentionner un outil de ligne de commande appelérlwrap qui ajoute gratuitement de puissantes fonctionnalités d'édition de ligne à vos scripts Python. Vous n'avez rien à faire pour que cela fonctionne!

Supposons que vous ayez écrit une interface de ligne de commande qui comprend trois instructions, dont une pour ajouter des nombres:

À première vue, cela semble être une invite typique lorsque vous l'exécutez:

Mais dès que vous faites une erreur et que vous souhaitez la corriger, vous verrez qu'aucune des touches de fonction ne fonctionne comme prévu. Frapper la flèche[.kbd .key-arrow-left]#Left #, par exemple, entraîne ceci au lieu de déplacer le curseur vers l'arrière:

Maintenant, vous pouvez encapsuler le même script avec la commanderlwrap. Non seulement vous obtiendrez les touches fléchées fonctionnelles, mais vous pourrez également rechercher dans l'historique persistant de vos commandes personnalisées, utiliser la saisie semi-automatique et modifier la ligne avec des raccourcis:

N'est-ce pas génial?