2. Mode d'emploi de l'interpréteur Python
*****************************************


2.1. Lancement de l'interpréteur
================================

L'interpréteur Python se trouve en général comme
"/usr/local/bin/python3.7" sur ces machines où il est disponible ;
ajoutez "/usr/local/bin" au chemin de recherche de votre shell Unix
afin de pouvoir le lancer en tapant la commande :

   python3.7

dans le shell. [1] Le choix du répertoire où se trouve l'interpréteur
étant une option d'installation, d'autres chemins sont possibles ;
voyez avec votre gourou Python local ou votre administrateur système
(par exemple, "/usr/local/python" est un endroit courant).

On Windows machines where you have installed Python from the Microsoft
Store, the "python3.7" command will be available. If you have the
py.exe launcher installed, you can use the "py" command. See
Digression : Définition des variables d'environnement for other ways
to launch Python.

Tapez un caractère de fin de fichier ("Ctrl-D" sous Unix, "Ctrl-Z"
sous Windows) dans une invite de commande primaire provoque la
fermeture de l'interpréteur avec un code de sortie nul. Si cela ne
fonctionne pas, vous pouvez fermer l'interpréteur en tapant la
commande "quit()".

The interpreter's line-editing features include interactive editing,
history substitution and code completion on systems that support the
GNU Readline library. Perhaps the quickest check to see whether
command line editing is supported is typing "Control-P" to the first
Python prompt you get.  If it beeps, you have command line editing;
see Appendix Édition interactive des entrées et substitution
d'historique for an introduction to the keys.  If nothing appears to
happen, or if "^P" is echoed, command line editing isn't available;
you'll only be able to use backspace to remove characters from the
current line.

L'interpréteur fonctionne de façon similaire au shell Unix : lorsqu'il
est appelé avec l'entrée standard connectée à un périphérique tty, il
lit et exécute les commandes de façon interactive ; lorsqu'il est
appelé avec un nom de fichier en argument ou avec un fichier comme
entrée standard, il lit et exécute un *script* depuis ce fichier.

Une autre façon de lancer l'interpréteur est "python -c commande [arg]
...". Cela exécute les instructions de *commande* de façon analogue à
l'option "-c" du shell. Parce que les instructions Python contiennent
souvent des espaces et d'autres caractères spéciaux pour le shell, il
est généralement conseillé de mettre *commande* entre guillemets
simples.

Certains modules Python sont aussi utiles en tant que scripts. Ils
peuvent être appelés avec "python -m module [arg] ..." qui exécute le
fichier source de *module* comme si vous aviez tapé son nom complet
dans la ligne de commande.

Quand un fichier de script est utilisé, il est parfois utile de
pouvoir lancer le script puis d'entrer dans le mode interactif après
coup. Cela est possible en passant "-i" avant le script.

Tous les paramètres utilisables en ligne de commande sont documentés
dans Ligne de commande et environnement.


2.1.1. Passage d'arguments
--------------------------

Lorsqu'ils sont connus de l'interpréteur, le nom du script et les
arguments additionnels sont représentés sous forme d'une liste
assignée à la variable "argv" du module "sys". Vous pouvez y accéder
en exécutant "import sys". La liste contient au minimum un élément ;
quand aucun script ni aucun argument n'est donné, "sys.argv[0]" est
une chaine vide. Quand "'-'" (qui représente l'entrée standard) est
passé comme nom de script, "sys.argv[0]" contient "'-'". Quand "-c"
*commande* est utilisé, "sys.argv[0]" contient "'-c'". Enfin, quand
"-m" *module* est utilisé, le nom complet du module est assigné à
"sys.argv[0]". Les options trouvées après "-c" *commande* ou "-m"
*module* ne sont pas lues comme options de l'interpréteur Python mais
laissées dans "sys.argv" pour être utilisées par le module ou la
commande.


2.1.2. Mode interactif
----------------------

Lorsque des commandes sont lues depuis un tty, l'interpréteur est dit
être en *mode interactif*. Dans ce mode, il demande la commande
suivante avec le *prompt primaire*, en général trois signes plus-
grand-que (">>>") ; pour les lignes de continuation, il affiche le
*prompt secondaire*, par défaut trois points ("..."). L'interpréteur
affiche un message de bienvenue indiquant son numéro de version et une
notice de copyright avant d'afficher le premier prompt :

   $ python3.7
   Python 3.7 (default, Sep 16 2015, 09:25:04)
   [GCC 4.8.2] on linux
   Type "help", "copyright", "credits" or "license" for more information.
   >>>

Les lignes de continuation sont nécessaires pour entrer une
construction multi-lignes. Par exemple, regardez cette instruction
"if" :

   >>> the_world_is_flat = True
   >>> if the_world_is_flat:
   ...     print("Be careful not to fall off!")
   ...
   Be careful not to fall off!

Pour plus d'informations sur le mode interactif, voir Mode interactif.


2.2. L'interpréteur et son environnement
========================================


2.2.1. Encodage du code source
------------------------------

Par défaut, Python considère que ses fichiers sources sont encodés en
UTF-8. Dans cet encodage, les caractères de la plupart des langues
peuvent être utilisés ensemble dans les chaînes de caractères,
identifiants et commentaires. Notez que la bibliothèque standard
n'utilise que des caractères ASCII dans ses identifiants et que nous
considérons que c'est une bonne habitude que tout code portable
devrait suivre. Pour afficher correctement tous ces caractères, votre
éditeur doit reconnaître que le fichier est en UTF-8 et utiliser une
police qui comprend tous les caractères utilisés dans le fichier.

Pour annoncer un encodage différent de l'encodage par défaut, une
ligne de commentaire particulière doit être ajoutée en tant que
*première* ligne du fichier.  Sa syntaxe est la suivante :

   # -*- coding: encoding -*-

où *encoding* est un des "codecs" supporté par Python.

Par exemple, pour déclarer un encodage *Windows-1252*, la première
ligne de votre code source doit être :

   # -*- coding: cp1252 -*-

Une exception à la règle *première ligne* est lorsque la première
ligne est un shebang UNIX. Dans ce cas, la déclaration de l'encodage
doit être placée sur la deuxième ligne du fichier. Par exemple :

   #!/usr/bin/env python3
   # -*- coding: cp1252 -*-

-[ Notes ]-

[1] Sous Unix, par défaut, l'interpréteur Python 3.x n'est pas
    installé sous le nom de "python" afin de ne pas entrer en conflit
    avec une éventuelle installation de Python 2.x.
