Python, de zéro

Exemple à partir d’un dossier « xxx »

Fichier « xxx/calculs.py »

#!/usr/bin/env python3
# coding: utf-8

def sqrt(n): return n ** 0.5
def carre(n): return n ** 2

Fichier « main.py » (import du nom complet du module « xxx.calculs.py »)

#!/usr/bin/env python3
# coding: utf-8

import xxx.calculs
print("La racine de 25 est %f et son carré est %d" % xxx.calculs.sqrt(25), xxx.calculs.carre(25))

Fichier « main.py » (import du nom du module « calculs.py »par rapport à son dossier « xxx »)

#!/usr/bin/env python3
# coding: utf-8

from xxx import calculs
print("La racine de 25 est %f et son carré est %d" % calculs.sqrt(25), calculs.carre(25))

Fichier « main.py » (import du contenu entier du module « xxx.calculs.py »)

#!/usr/bin/env python3
# coding: utf-8

from xxx.calculs import *
print("La racine de 25 est %f et son carré est %d" % sqrt(25), carre(25))

Python pourra aussi importer un dossier directement par son nom à condition que ce dossier possède un fichier spécifique nommé « __init__.py ». Lors de l'import du dossier, ce fichier « __init__.py » est alors exécuté.

Exemple (suite du précédent)

Fichier « xxx/__init__.py »

#!/usr/bin/env python3
# coding: utf-8
import calculs

Fichier « main.py » (import du dossier « xxx » lequel fera importer par « __init__.py » le module « calculs.py » qui restera local à « xxx »)

#!/usr/bin/env python3
# coding: utf-8

import xxx
print("La racine de 25 est %f et son carré est %d" % xxx.calculs.sqrt(25), xxx.calculs.carre(25))

Fichier « main.py » (import du contenu du dossier « xxx », lequel fera importer par « __init__.py » le module « calculs.py » qui sera alors global dans le code)

#!/usr/bin/env python3
# coding: utf-8

from xxx import *
print("La racine de 25 est %f et son carré est %d" % calculs.sqrt(25), calculs.carre(25))

À noter : les imports sont recherchés depuis une liste des dossiers stockée dans la variable sys.path. Cette liste contient entre autres un dossier vide ("") signifiant « dossier de l’exécutable appelé ».

Modules intégrés en standard dans la librairie Python :

• __future__ : bibliothèque de variables et outils qui ordonnent à une version Python de se comporter comme se comportera la version suivante sur certaines caractéristiques ;

• abc : bibliothèque de variables et d’outils fournissant une infrastructure pour définir des classes abstraites (Abstract Base Class) ;

• atexit : bibliothèque de variables et d’outils qui permettent d'activer des fonctions qui seront automatiquement appelées lorsque le programme se termine ou s'interrompt ;

• binascii et base64 : bibliothèques de variables et d’outils qui permettent de coder/décoder un flux binaire en représentation ASCII pour la première et en diverses représentations pour la seconde (la seconde est un enrobage enrichi de la première) ;

• builtins : bibliothèque contenant toutes les fonctions natives Python. Cela permet de créer sa propre fonction qui surchargera une fonction native et qui pourra donc appeler ladite fonction sans tomber dans un appel récursif ;

• collections : bibliothèque d’extensions spécifiques des containers de base (tuples, listes, ensembles et dictionnaires) ;

• configparser (anciennement ConfigParser dans Python 2) : bibliothèque de variables et d’outils qui permettent de gérer un fichier de configuration ;

• copy : bibliothèque de variables et d’outils permettant de dupliquer des objets Python ;

• csv : bibliothèque de variables et d’outils permettant de manipuler un fichier de type csv ;

• ctypes : bibliothèque de variables et d’outils permettant d'attaquer des modules écrits en C ;

• curses : bibliothèque de variables et d’outils permettant de gérer l'écran et son affichage ;

• dataclasses : bibliothèque de décorateurs qui peuvent créer automatiquement des méthodes standards (telles __init__() ou __repr__()) aux objets sur certaines spécifications ;

• datetime : bibliothèque de variables et d’outils qui permettent de gérer les dates et les heures ;

• decimal : bibliothèque de variables et d’outils qui permettent de gérer et calculer les nombres décimaux avec une précision absolue ;

• doctest : bibliothèque de variables et d’outils qui permettent de tester la documentation ;

• enum : bibliothèque de variables et d’outils qui permettent de créer des constantes symboliques (n'existe pas dans Python 2) ;

• fileinput : bibliothèque de variables et d’outils qui permettent de manipuler les fichiers standards (stdin, stdout et stderr) ;

• fractions : bibliothèque de variables et d’outils qui permettent de manipuler les fractions ;

• functools : bibliothèque de variables et d’outils qui permettent de manipuler les fonctions ;

• getopt : bibliothèque de variables et d’outils qui permettent de gérer les options format Unix ;

• grp : bibliothèque de variables et d’outils de manipulation de la base de données Unix gérant l’association entre groupe et gid (fichier « /etc/group ») ;

• hashlib : bibliothèque de variables et d’outils qui permettent de hasher (signer) un flux ;

• importlib : bibliothèque de variables et d’outils qui permettent d’importer des modules de façon dynamique ou paramétrable ;

• inspect : bibliothèque de variables et d’outils qui permettent de récupérer des informations sur les objets du code ;

• io : bibliothèque de variables et d’outils qui permettent de manipuler des descripteurs de fichiers (des flux IO) ;

• itertools : bibliothèque de variables et d’outils qui permettent de créer des itérateurs puissants ;

• json : bibliothèque de variables et d’outils qui permettent de manipuler des données au format JSON ;

• keyword : bibliothèque de variables et d’outils qui permettent de gérer les mots‑clef du langage ;

• logging : bibliothèque de variables et d’outils qui permettent de logguer des événements et actions ;

• math : bibliothèque de variables et d’outils qui permettent d'accéder à des fonctions mathématiques avancées ;

• numbers : classe de base abstraite numérique gérant la hiérarchie des nombres ;

• operator : contient toutes les fonctions correspondant aux opérateurs natifs, opérateurs pouvant alors être utilisables en tant qu’objets ;

• os : bibliothèque de variables et d’outils permettant d'accéder au système d'exploitation ;

• pathlib : bibliothèque représentant le système de fichiers avec la sémantique appropriée pour différents systèmes d'exploitation ;

• pdb : débogueur Python interactif ;

• pickle et _pickle (nommé cpickle dans Python 2) : bibliothèque de variables et d’outils qui permettent de sérialiser des objets Python. Le second _pickle (ou cpickle dans Python 2) correspond au premier, mais a été écrit en C pour être plus rapide ;

• pwd : bibliothèque de variables et d’outils de manipulation de la base de données Unix gérant l’association entre utilisateur et uid (fichier « /etc/passwd ») ;

• random : bibliothèque de variables et d’outils de génération de nombres aléatoires ;

• re : bibliothèque de variables et d’outils qui permettent d’utiliser des expressions régulières ;

• spwd : bibliothèque de variables et d’outils de manipulation de la base de données Unix gérant l’association entre utilisateur et mot de passe (fichier « /etc/shadow ») ;

• StringIO (Python 2 uniquement) : bibliothèque de variables et d’outils qui permettent de manipuler une chaîne comme un flux IO (intégré au module io dans Python 3) ;

• struct : bibliothèque de variables et d’outils qui permettent d’effectuer des conversions entre valeurs Python et structures binaires du C ;

• statistics : bibliothèque de variables et d’outils de calculs statistiques ;

• subprocess : bibliothèque de variables et d’outils permettant de lancer des programmes externes (des processus) et récupérer leur travail au travers de tubes de communication ;

• sys : bibliothèque de variables et d’outils permettant d'accéder au système dans lequel se déroule le script ;

• time : bibliothèque de variables et d’outils qui permettent de gérer les heures ;

• timeit : bibliothèque de variables et d’outils qui permettent d’effectuer des statistiques sur le temps d’exécution d’une fonction ;

• types : contient les types Python sous forme de variables. Dans Python 2, ce module contenait tous les types possibles (str, int, long, etc). Dans Python 3, il ne contient que les types qui ne sont pas déjà un objet existant (ex int n'est pas présent dans ce module, car l'objet int existe et peut être utilisé à sa place) ;

• typing : contient un support de prise en charge des annotations ;

• unicodedata : bibliothèque de variables et d’outils qui permettent de manipuler l’Unicode ;

• unittest : bibliothèque de variables et d’outils qui permettent d'automatiser des tests de fonctions et classes ;

• uuid : bibliothèque de variables et d’outils qui permettent de générer des UUID (Unique UID).

• xml : bibliothèque de variables et d’outils qui permettent de manipuler les fichiers xml.

• zlib : bibliothèque de variables et d’outils qui permettent de compresser ou décompresser un flux.

Modules nécessitant une installation spécifique, mais très souvent utilisés par nombre de développeurs Python :

• Cryptodome (anciennement nommé Crypto) : bibliothèque de variables et d’outils de chiffrement/déchiffrement selon différents algorithmes (Diffie-Hellman, RSA, etc.) ;

• matplotlib : bibliothèque de visualisation de fonctions et courbes mathématiques ;

• numpy : bibliothèque permettant la manipulation de matrices et tableaux multidimensionnels ;

• pandas : bibliothèque permettant la manipulation et l'analyse des données, tableaux numériques et séries temporelles ;

• psutil : bibliothèque de variables et d’outils de contrôle des processus et de charge système ;

• tkinter (nommé Tkinter dans Python 2) : bibliothèque de variables et d’outils qui permettent de créer des IHM graphiques minimalistes basée sur la librairie tcl/tk ;

• Pygtk : bibliothèque permettant de créer des IHM graphiques basées sur la librairie graphique GTK ;

• PyQt et PySide : bibliothèques permettant de créer des IHM graphiques basées sur la librairie graphique Qt. Le module PySide est une branche dérivée issue de PyQt ayant maintenant sa propre vie;