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 macOS

  • 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

25.5.2.1. Editor windows

IDLE may open editor windows when it starts, depending on settings and how you start IDLE. Thereafter, use the File menu. There can be only one open editor window for a given file.

The title bar contains the name of the file, the full path, and the version of Python and IDLE running the window. The status bar contains the line number (“Ln”) and column number (“Col”). Line numbers start with 1; column numbers with 0.

IDLE assumes that files with a known .py* extension contain Python code and that other files do not. Run Python code with the Run menu.

25.5.2.2. Key bindings

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

  • 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 recule d’un caractère sans le supprimer (habituellement vous pouvez également utiliser les touches flèches pour faire cela)

    • 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.3. Indentation automatique

Après une structure d’ouverture de bloc, la prochaine ligne est indentée de 4 espaces (dans la console Python d’une tabulation). Après certains mots-clefs (break, return etc) la ligne suivante est dédentée. Dans une indentation au début de la ligne, Retour arrière supprime jusqu’à 4 espaces s’il y en a. Tab insère des espaces (dans la console, une tabulation), en nombre dépendant de la configuration. Les tabulations sont actuellement restreintes à quatre espaces à cause de limitations de Tcl/Tk.

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

25.5.2.4. 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 » force l’ouverture d’une fenêtre de complétion, par défaut C-espace ouvre une fenêtre de complétion. Dans une chaîne vide, cette fenêtre contient les fichiers du dossier actif. Sur une ligne vide, elle contient les fonctions et classes intégrées par défaut et définies par l’utilisateur de l’espace de nommage actif, plus tous les modules importés. Si des caractères ont été saisis, l”ACW essaie d’être plus spécifique.

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.5. Info-bulles

Une info-bulle est affichée quand vous saisissez ( après le nom d’une fonction accessible. Une expression de nom peut inclure des points et des tirets bas.L’info-bulle reste affichée jusqu’à ce que vous cliquiez dessus, que le curseur se déplace hors de la zone des arguments, ou que ) soit saisi. Quand le curseur est dans la partie « arguments » de la définition, le menu ou raccourci affiche une info-bulle.

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.6. Fenêtre de console Python

With IDLE’s Shell, one enters, edits, and recalls complete statements. Most consoles and terminals only work with a single physical line at a time.

When one pastes code into Shell, it is not compiled and possibly executed until one hits Return. One may edit pasted code first. If one pastes more that one statement into Shell, the result will be a SyntaxError when multiple statements are compiled as if they were one.

The editing features described in previous subsections work when entering code interactively. IDLE’s Shell window also responds to the following keys.

  • 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 macOS use C-p.

    • Alt-n retrieves next. On macOS use C-n.

    • Entrée sur une des commandes précédentes récupère cette commande

25.5.2.7. 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. Échec au démarrage

IDLE utilise un connecteur (socket en anglais) pour communiquer entre le processus d’interface graphique d”IDLE et le processus d’exécution de code de l’utilisateur. Une connexion doit être établie quand la console démarre ou redémarre (le redémarrage est indiqué par une ligne de division avec « RESTART »). Si le processus utilisateur échoue à établir une connexion avec le processus graphique, il affiche une fenêtre d’erreur Tk avec un message « connexion impossible » qui redirige l’utilisateur ici. Ensuite, il s’arrête.

Une cause d’échec courant est un fichier écrit par l’utilisateur avec le même nom qu’un module de la bibliothèque standard, comme random.py et tkinter.py. Quand un fichier de ce genre est enregistré dans le même répertoire qu’un fichier à exécuter, IDLE ne peut pas importer le fichier standard. La solution actuelle consiste à renommer le fichier de l’utilisateur.

Même si c’est plus rare qu’avant, un antivirus ou un pare-feu peuvent interrompre la connexion. Si le programme ne peut pas être paramétré pour autoriser la connexion, alors il doit être éteint pour qu”IDLE puisse fonctionner. Cette connexion interne est sûre car aucune donnée n’est visible depuis un port extérieur. Un problème similaire est une mauvaise configuration du réseau qui bloque les connexions.

Des problèmes d’installation de Python stoppent parfois IDLE : il peut y avoir un conflit de versions ou bien l’installation peut nécessiter des privilèges administrateurs. Si on corrige le conflit , ou qu’on ne peut ou ne veut pas accorder de privilège, il peut être plus facile de désinstaller complètement Python et de recommencer.

Un processus pythonw.exe zombie peut être un problème. Sous Windows, utilisez le Gestionnaire des Tâches pour en détecter puis en arrêter un. Parfois, un redémarrage causé par un plantage ou une interruption clavier (Ctrl-C) peut ne pas réussir à se connecter. Fermer la fenêtre d’erreur ou redémarrer la console dans le menu Shell peut résoudre un problème temporaire.

Quand IDLE démarre pour la première fois, il essaie de lire la configuration de l’utilisateur dans les fichiers de ~/.idlerc (~ est le répertoire personnel de l’utilisateur). S’il y a un problème, un message d’erreur devrait être affiché. Mis à part les erreurs aléatoires du disque dur, ceci peut être évité en n’éditant jamais les fichiers directement, mais en utilisant la fenêtre de configuration, dans Options. Quand cela arrive, la solution peut être de supprimer un ou plusieurs des fichiers de configuration.

Si IDLE se ferme sans message et qu’il n’a pas été démarré depuis une console, essayez de le démarrer depuis une console (python -m idlelib) et regardez si un message apparaît.

25.5.3.3. Running user code

With rare exceptions, the result of executing Python code with IDLE is intended to be the same as executing the same code by the default method, directly with Python in a text-mode system console or terminal window. However, the different interface and operation occasionally affect visible results. For instance, sys.modules starts with more entries, and threading.activeCount() returns 2 instead of 1.

By default, IDLE runs user code in a separate OS process rather than in the user interface process that runs the shell and editor. In the execution process, it replaces sys.stdin, sys.stdout, and sys.stderr with objects that get input from and send output to the Shell window. The original values stored in sys.__stdin__, sys.__stdout__, and sys.__stderr__ are not touched, but may be None.

When Shell 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. These include system-specific functions that determine whether a key has been pressed and if so, which.

IDLE’s standard stream replacements are not inherited by subprocesses created in the execution process, whether directly by user code or by modules such as multiprocessing. If such subprocess use input from sys.stdin or print or write to sys.stdout or sys.stderr, IDLE should be started in a command line window. The secondary subprocess will then be attached to that window for input and output.

If sys is reset by user code, such as with importlib.reload(sys), IDLE’s changes are lost and input from the keyboard and output to the screen will not work correctly.

25.5.3.4. User output in Shell

When a program outputs text, the result is determined by the corresponding output device. When IDLE executes user code, sys.stdout and sys.stderr are connected to the display area of IDLE’s Shell. Some of its features are inherited from the underlying Tk Text widget. Others are programmed additions. Where it matters, Shell is designed for development rather than production runs.

For instance, Shell never throws away output. A program that sends unlimited output to Shell will eventually fill memory, resulting in a memory error. In contrast, some system text windows only keep the last n lines of output. A Windows console, for instance, keeps a user-settable 1 to 9999 lines, with 300 the default.

Text widgets display a subset of Unicode, the Basic Multilingual Plane (BMP). Which characters get a proper glyph instead of a replacement box depends on the operating system and installed fonts. Newline characters cause following text to appear on a new line, but other control characters are either replaced with a box or deleted. However, repr(), which is used for interactive echo of expression values, replaces control characters, some BMP codepoints, and all non-BMP characters with escape codes before they are output.

Normal and error output are generally kept separate (on separate lines) from code input and each other. They each get different highlight colors.

For SyntaxError tracebacks, the normal “^” marking where the error was detected is replaced by coloring the text with an error highlight. When code run from a file causes other exceptions, one may right click on a traceback line to jump to the corresponding line in an IDLE editor. The file will be opened if necessary.

Shell has a special facility for squeezing output lines down to a “Squeezed text” label. This is done automatically for output over N lines (N = 50 by default). N can be changed in the PyShell section of the General page of the Settings dialog. Output with fewer lines can be squeezed by right clicking on the output. This can be useful lines long enough to slow down scrolling.

Squeezed output is expanded in place by double-clicking the label. It can also be sent to the clipboard or a separate view window by right-clicking the label.

25.5.3.5. Développer des applications tkinter

IDLE is intentionally different from standard Python in order to facilitate development of tkinter programs. Enter import tkinter as tk; root = tk.Tk() in standard Python and nothing appears. Enter the same in IDLE and a tk window appears. In standard Python, one must also enter root.update() to see the window. IDLE does the equivalent in the background, about 20 times a second, which is about every 50 milleseconds. Next enter b = tk.Button(root, text='button'); b.pack(). Again, nothing visibly changes in standard Python until one enters root.update().

La plupart des programmes tkinter exécutent root.mainloop(), qui d’habitude ne renvoie pas jusqu’à ce que l’application tk soit détruite. Si le programme est exécuté avec python -i``ou depuis un éditeur *IDLE*, une invite de commande ``>>> n’apparaît pas tant que mainloop() ne termine pas, c’est-à-dire quand il ne reste plus rien avec lequel interagir.

Avec un programme tkinter exécuté depuis un éditeur IDLE, vous pouvez immédiatement commenter l’appel à mainloop. On a alors accès à une invite de commande et on peut interagir en direct avec l’application. Il faut juste se rappeler de réactiver l’appel à mainloop lors de l’exécution en Python standard.

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

Si la tentative de connexion par le socket échoue, IDLE vous le notifie. Ce genre d’échec est parfois temporaire, mais s’il persiste, le problème peut soit venir d’un pare-feu qui bloque la connexion ou d’une mauvaise configuration dans un système particulier. Jusqu’à ce que le problème soit résolu, vous pouvez exécuter IDLE avec l’option -n de la ligne de commande.

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. Help sources

Help menu entry « IDLE Help » displays a formatted html version of the IDLE chapter of the Library Reference. The result, in a read-only tkinter text window, is close to what one sees in a web browser. Navigate through the text with a mousewheel, the scrollbar, or up and down arrow keys held down. Or click the TOC (Table of Contents) button and select a section header in the opened box.

Help menu entry « Python Docs » opens the extensive sources of help, including tutorials, available at docs.python.org/x.y, where “x.y” is the currently running Python version. If your system has an off-line copy of the docs (this may be an installation option), that will be opened instead.

Selected URLs can be added or removed from the help menu at any time using the General tab of the Configure IDLE dialog .

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. IDLE on macOS

Under System Preferences: Dock, one can set « Prefer tabs when opening documents » to « Always ». This setting is not compatible with the tk/tkinter GUI framework used by IDLE, and it breaks a few IDLE features.

25.5.4.4. Extensions

IDLE inclut un outil d’extensions. Les préférences pour les extensions peuvent être changées avec l’onglet Extensions de la fenêtre de préférences. Lisez le début de config-extensions.def dans le dossier idlelib pour plus d’informations. La seule extension actuellement utilisée par défaut est zzdummy, un exemple également utilisé pour les tests.