Documentation Python
Documentation du langage Python, tutoriels et références de bibliothèque standard, à consulter dans la version correspondant à son environnement.
Capture de la page d’accueil du . Le site actuel peut avoir évolué.
Vérifier un comportement Python
Lire la documentation du langage et de sa bibliothèque standard.
Avant de vous appuyer sur le résultat : Choisir la version qui correspond à l’environnement utilisé.
Comparer avec les autres besoins de la rubrique →
Comparer cette ressource avec d’autres fiches →
Décrire l’environnement d’un exemple Python
- Code du projet
- Conserver les fichiers de travail.
- Environnement venv
- Identifier les dépendances installées.
- Repérez le code du projet et son environnement séparément.
- Notez l’interpréteur Python utilisé pour reproduire l’exemple.
- Conservez les dépendances nécessaires à la recréation de l’environnement.
Exemple fictif : une étudiante reproduit un notebook sur deux ordinateurs. Le code est identique, mais les paquets diffèrent. Elle consigne les dépendances et l’interpréteur avant de comparer les résultats, puis garde son code hors du dossier de l’environnement.
Votre trace utile : Version de Python, dépendances nécessaires et dossier du code.
Un environnement isolé ne prouve pas la reproductibilité scientifique du résultat.
Choisir une autre méthode commentée
Méthode éditoriale construite à partir de Python Documentation — venv. Documentation consultée le . Les exemples sont des exercices fictifs, pas des résultats de test du service.
Utiliser la documentation de la bonne version de Python
Le site Python distingue tutoriel, référence du langage, bibliothèque standard et guides d’installation. Commencez par relever la version utilisée dans votre environnement, puis choisissez la documentation correspondante.
- Tutoriel
- Apprendre les concepts et usages du langage.
- Bibliothèque standard
- Vérifier signatures, comportements et exceptions.
- Version
- Comparer la version de documentation à celle de l’interpréteur.
- Environnement du projet
- Un environnement venv dispose de ses propres paquets, isolés par défaut de ceux de l’installation de base. Identifier son interpréteur avant de reproduire un exemple.
- Reproduction
- Conserver la version Python et la liste des dépendances du projet. Recréer l’environnement sur la machine cible plutôt que copier simplement son dossier.
- Identifier l’interpréteur
- L’option --version affiche la version de l’interpréteur appelé puis quitte. Exécuter cette vérification dans le contexte du projet : deux commandes ou environnements peuvent appeler des installations différentes.
Source : Python — Command line and environment · consultée le - Comprendre -m
- L’option -m recherche un module avec le mécanisme d’importation puis l’exécute comme script. Elle ne signifie pas « installer ce module » ; distinguer installation, importation et exécution dans vos notes.
Source : Python — Command line and environment · consultée le - Environnement isolé
- venv crée un environnement dont les paquets sont isolés par défaut.
Source : Python Documentation — venv · consultée le - Projet et environnement
- Le répertoire de l’environnement n’est pas destiné au code du projet.
Source : Python Documentation — venv · consultée le
Le manuel de la dernière version décrit-il forcément mon environnement ?
Non. Sélectionnez la version installée et vérifiez les changements indiqués pour la fonction utilisée.
Documentation du profil initial
- Utiliser la documentation de la bonne version de Python / Use documentation for the right Python version ↗
- Python — Environnements virtuels venv ↗
Documentation du profil initial consultée le . Les repères ajoutés portent leur propre source et date de consultation ci-dessus.
