25.5. IDLE

Code source : Lib/idlelib/

IDLE est l’environnement de développement et d’apprentissage intégré de Python (Integrated Development and Learning Environment).

IDLE a les fonctionnalités suivantes :

  • codé à 100% en pur Python, en utilisant l’outil d’interfaçage graphique tkinter
  • cross-platform: works mostly the same on Windows, Unix, and Mac OS X
  • Console Python (interpréteur interactif) avec coloration du code entré, des sorties et des messages d’erreur
  • éditeur de texte multi-fenêtres avec annulations multiples, coloration Python, indentation automatique, aide pour les appels de fonction, autocomplétion, parmi d’autres fonctionnalités
  • recherche dans n’importe quelle fenêtre, remplacement dans une fenêtre d’édition et recherche dans des fichiers multiples (grep)
  • débogueur avec points d’arrêt persistants, pas-à-pas et visualisation des espaces de nommage locaux et globaux
  • configuration, navigateur et d’autres fenêtres de dialogue

25.5.2. Édition et navigation

In this section, “C” refers to the Control key on Windows and Unix and the Command key on Mac OSX.

  • Retour arrière supprime à gauche ; Suppr supprime à droite

  • C-Retour arrière supprime le mot à gauche ; C-Suppr supprime le mot à droite

  • Utilisez les touches flèche et Page Haut / Page Bas pour vous déplacer

  • C-Flèche Gauche et C-Flèche Droite déplacent de mot en mot

  • Début/Fin vont au début / à la fin de la ligne

  • C-Début / C-Fin vont au début / à la fin du fichier

  • Quelques raccourcis Emacs utiles sont hérités de Tcl/Tk :

    • C-a début de ligne
    • C-e fin de ligne
    • C-k supprime la ligne (mais ne la met pas dans le presse-papier)
    • C-l centre la fenêtre autour du point d’insertion
    • C-b go backward one character without deleting (usually you can also use the cursor key for this)
    • C-f avance d’un caractère sans le supprimer (habituellement vous pouvez également utiliser les touches flèches pour faire cela)
    • C-p remonte d’une ligne (habituellement vous pouvez également utiliser les touches flèches pour faire cela)
    • C-d supprime le caractère suivant

Les raccourcis clavier standards (comme C-c pour copier et C-v pour coller) peuvent fonctionner. Les raccourcis clavier sont sélectionnés dans la fenêtre de configuration d”IDLE.

25.5.2.1. Indentation automatique

After a block-opening statement, the next line is indented by 4 spaces (in the Python Shell window by one tab). After certain keywords (break, return etc.) the next line is dedented. In leading indentation, Backspace deletes up to 4 spaces if they are there. Tab inserts spaces (in the Python Shell window one tab), number depends on Indent width. Currently, tabs are restricted to four spaces due to Tcl/Tk limitations.

See also the indent/dedent region commands in the edit menu.

25.5.2.2. Complétions

Les complétions sont fournies pour les fonctions, classes et attributs de classes incluses par défaut et celles définies par l’utilisateur. Les complétions sont aussi fournies pour les noms de fichiers.

La fenêtre d’auto-complétion (ACW, AutoCompleteWindow) s’ouvre après un délai prédéfini (deux secondes par défaut) après qu’un « . »** ou (dans une chaîne) un os.sep est saisi. Si, après un de ces caractères (éventuellement suivi d’autres caractères), une tabulation est saisie, l”ACW s’ouvre immédiatement si une complétion compatible est trouvée.

S’il n’y a qu’une seule complétion possible pour le caractère saisi, un Tab fournit cette complétion sans ouvrir l”ACW.

“Show Completions” will force open a completions window, by default the C-space will open a completions window. In an empty string, this will contain the files in the current directory. On a blank line, it will contain the built-in and user-defined functions and classes in the current namespaces, plus any modules imported. If some characters have been entered, the ACW will attempt to be more specific.

Si une chaîne de caractère est saisie, la sélection de l”ACW va à l’entrée la plus proche de ces caractères. Saisir un Tab saisit la plus longue correspondance non ambiguë dans la console ou l’éditeur. Deux Tab à la suite fournissent la sélection de l”ACW, de la même manière que la touche « Entrée » ou un double-clic. Les touches flèches, Page Haut/Bas, la sélection à la souris et la molette de la souris fonctionnent tous sur l”ACW.

Les attributs « cachés » peuvent être atteints en saisissant le début d’un nom caché après un « . », e.g. »**_ ». Ceci permet l’accès aux modules utilisant __all__ ou aux attributs privés des classes.

Les complétions et la fonctionnalité « *Expand Word »* peuvent vous faire économiser beaucoup de temps !

Les complétions sont actuellement limitées à ce qui est présent dans les espaces de nommage. Les noms dans une fenêtre d’édition qui ne viennent pas de __main__ et sys.modules ne sont pas trouvés. Exécutez votre module avec vos importations pour corriger cette situation. Notez qu”IDLE lui-même place quelques modules dans sys.modules, qui peuvent être donc accédés par défaut, comme le module re.

Si vous n’aimez pas que l”ACW s’affiche spontanément, vous pouvez simplement augmenter le délai ou désactiver l’extension.

25.5.2.3. Info-bulles

A calltip is shown when one types ( after the name of an acccessible function. A name expression may include dots and subscripts. A calltip remains until it is clicked, the cursor is moved out of the argument area, or ) is typed. When the cursor is in the argument part of a definition, the menu or shortcut display a calltip.

Une info-bulle contient la signature de la fonction et la première ligne de la docstring. Pour les fonctions incluses par défaut sans signature accessible, l’info-bulle contient toutes les lignes jusqu’à la cinquième ligne ou la première ligne vide. Ces détails sont sujets à changement.

L’ensemble des fonctions accessibles dépend des modules qui ont été importés dans le processus utilisateur, y compris ceux importés par IDLE lui-même et quelles définitions ont été exécutées, le tout depuis le dernier redémarrage.

Par exemple, redémarrez la console et saisissez itertools.count(. Une info-bulle s’affiche parce que IDLE importe itertools dans le processus utilisateur pour son propre usage (ceci pourrait changer). Saisissez turtle.write( et rien ne s’affiche. IDLE n’importe pas turtle. Le menu ou le raccourci ne font rien non plus. Saisir import *turtle puis turtle.write( fonctionnera.

Dans l’éditeur, les commandes d’importation n’ont pas d’effet jusqu’à ce que le fichier soit exécuté. Vous pouvez exécuter un fichier après avoir écrit les commandes d’importation au début, ou immédiatement exécuter un fichier existant avant de l’éditer.

25.5.2.4. Fenêtre de console Python

  • C-c interrompt l’exécution de la commande

  • C-d envoie fin-de-fichier (EOF) ; cela ferme la fenêtre s’il est saisi à une invite >>>

  • Alt-/ (Compléter le mot) est également utile pour réduire la quantité de texte saisie

    Historique des commandes

    • Alt-p retrieves previous command matching what you have typed. On OS X use C-p.
    • Alt-n retrieves next. On OS X use C-n.
    • Entrée sur une des commandes précédentes récupère cette commande

25.5.2.5. Coloration du texte

IDLE affiche par défaut le texte en noir sur blanc mais colore le texte qui possède une signification spéciale. Pour la console, ceci concerne les sorties de la console et de l’utilisateur ainsi que les erreurs de l’utilisateur. Pour le code Python, dans l’invite de commande de la console ou sur un éditeur, ce sont les mots-clefs, noms de fonctions et de classes incluses par défaut, les noms suivant class et def, les chaînes de caractères et les commentaires. Pour n’importe quelle fenêtre de texte, ce sont le curseur (si présent), le texte trouvé (s’il y en a) et le texte sélectionné.

La coloration du texte est faite en arrière-plan, donc du texte non coloré est parfois visible. Pour changer les couleurs, utilisez l’onglet Highlighting de la fenêtre de configuration d”IDLE. Le marquage des points d’arrêt du débogueur dans l’éditeur et du texte dans les dialogues n’est pas configurable.

25.5.3. Démarrage et exécution du code

Quand il est démarré avec l’option -s, IDLE exécutera le fichier référencé par la variable d’environnement IDLE*STARTUP ou PYTHONSTARTUP. IDLE cherche d’abord IDLESTARTUP ; si IDLESTARTUP est présent, le fichier référencé est exécuté. Si IDLESTARTUP n’est pas présent, alors IDLE cherche PYTHONSTARTUP. Les fichiers référencés par ces variables d’environnement sont de bons endroits pour stocker des fonctions qui sont utilisées fréquemment depuis la console d”IDLE ou pour exécuter des commandes d’importation des modules communs.

De plus, Tk charge lui aussi un fichier de démarrage s’il est présent. Notez que le fichier de Tk est chargé sans condition. Ce fichier additionnel est .Idle.py et est recherché dans le dossier personnel de l’utilisateur. Les commandes dans ce fichier sont exécutées dans l’espace de nommage de Tk, donc ce fichier n’est pas utile pour importer des fonctions à utiliser depuis la console Python d”IDLE.

25.5.3.1. Utilisation de la ligne de commande

idle.py [-c command] [-d] [-e] [-h] [-i] [-r file] [-s] [-t title] [-] [arg] ...

-c command  run command in the shell window
-d          enable debugger and open shell window
-e          open editor window
-h          print help message with legal combinations and exit
-i          open shell window
-r file     run file in shell window
-s          run $IDLESTARTUP or $PYTHONSTARTUP first, in shell window
-t title    set title of shell window
-           run stdin in shell (- must be last option before args)

S’il y a des arguments :

  • Si -, -c ou -r sont utilisés, tous les arguments sont placés dans sys.argv[1:...] et sys.argv[0] est assigné à “”`, '-c', ou '-r'. Aucune fenêtre d’édition n’est ouverte, même si c’est le comportement par défaut fixé dans la fenêtre d’options.
  • Sinon, les arguments sont des fichiers ouverts pour édition et sys.argv reflète les arguments passés à IDLE lui-même.

25.5.3.2. IDLE-console differences

As much as possible, the result of executing Python code with IDLE is the same as executing the same code in a console window. However, the different interface and operation occasionally affect visible results. For instance, sys.modules starts with more entries.

IDLE also replaces sys.stdin, sys.stdout, and sys.stderr with objects that get input from and send output to the Shell window. When this window has the focus, it controls the keyboard and screen. This is normally transparent, but functions that directly access the keyboard and screen will not work. If sys is reset with importlib.reload(sys), IDLE’s changes are lost and things like input, raw_input, and print will not work correctly.

With IDLE’s Shell, one enters, edits, and recalls complete statements. Some consoles only work with a single physical line at a time. IDLE uses exec to run each statement. As a result, '__builtins__' is always defined for each statement.

25.5.3.3. Exécution sans sous-processus

Par défaut IDLE exécute le code de l’utilisateur dans un sous-processus séparé via un connecteur sur l’interface de la boucle locale. Cette connexion n’est pas visible de l’extérieur et rien n’est envoyé ou reçu d’Internet. Si un pare-feu s’en plaint quand même, vous pouvez l’ignorer.

If the attempt to make the socket connection fails, Idle will notify you. Such failures are sometimes transient, but if persistent, the problem may be either a firewall blocking the connection or misconfiguration of a particular system. Until the problem is fixed, one can run Idle with the -n command line switch.

Si IDLE est démarré avec l’option -n de la ligne de commande, il s’exécute dans un seul processus et ne crée pas de sous-processus pour exécuter le serveur RPC d’exécution de Python. Ceci peut être utile si Python ne peut pas créer de sous-processus ou de connecteur RPC sur votre plateforme. Cependant, dans ce mode, le code de l’utilisateur n’est pas isolé de IDLE lui-même. De plus, l’environnement n’est pas réinitialisé quand Run/Run Module (F5) est sélectionné. Si votre code a été modifié, vous devez reload*() les modules affectés et ré-importer tous les éléments spécifiques (e.g. *from foo import baz) pour que les changements prennent effet. Pour toutes ces raisons, il est préférable d’exécuter IDLE avec le sous-processus par défaut si c’est possible.

Obsolète depuis la version 3.4.

25.5.4. Aide et préférences

25.5.4.1. Additional help sources

IDLE includes a help menu entry called « Python Docs » that will open the extensive sources of help, including tutorials, available at docs.python.org. Selected URLs can be added or removed from the help menu at any time using the Configure IDLE dialog. See the IDLE help option in the help menu of IDLE for more information.

25.5.4.2. Modifier les préférences

The font preferences, highlighting, keys, and general preferences can be changed via Configure IDLE on the Option menu. Keys can be user defined; IDLE ships with four built-in key sets. In addition, a user can create a custom key set in the Configure IDLE dialog under the keys tab.

25.5.4.3. Extensions

IDLE contains an extension facility. Preferences for extensions can be changed with Configure Extensions. See the beginning of config-extensions.def in the idlelib directory for further information. The default extensions are currently:

  • FormatParagraph
  • AutoExpand
  • ZoomHeight
  • ScriptBinding
  • CallTips
  • ParenMatch
  • AutoComplete
  • CodeContext
  • RstripExtension