Modules Python débutant : importer, math, random

Difficulté

Facile

Les modules permettent d’ajouter rapidement des fonctions à un programme Python sans tout écrire soi-même. C’est une base très utile pour progresser, car presque tous les projets Python utilisent des modules.

Dans ce tutoriel, vous allez manipuler des imports simples, tester les modules math et random, puis créer votre propre module dans deux fichiers Python. Chaque étape reste concrète pour vous laisser avec un exemple réutilisable immédiatement.

Prérequis

Vous devez avoir Python installé et savoir exécuter un fichier .py. Un éditeur de texte simple ou un environnement comme IDLE, VS Code ou Thonny suffit.

Si vous débutez totalement, sachez seulement créer un fichier, l’enregistrer et lancer une commande Python. Le reste est guidé pas à pas.

Matériel nécessaire

• Python installé sur l’ordinateur
• Un éditeur de texte ou IDE
• Un terminal ou la console Python

Étapes

1. 1

   Créer un premier fichier de test

   Créez un fichier nommé test_modules.py. Ajoutez-y ce code, puis exécutez-le :

   print("Bonjour depuis Python")

   Cette vérification simple confirme que votre fichier s’exécute correctement avant d’ajouter des modules. Si le message s’affiche, vous pouvez continuer dans le même fichier.

2. 2

   Importer le module math

   Remplacez ou complétez votre fichier avec un import du module math. Testez ensuite une fonction et une constante :

   import math
   
   print(math.sqrt(25))
   print(math.pi)

   Au lancement, Python charge le module puis vous accédez à son contenu avec la notation math.nom. Ici, sqrt calcule une racine carrée et pi donne la constante correspondante.

3. 3

   Appeler plusieurs fonctions de math

   

   Ajoutez quelques lignes pour manipuler plusieurs outils du module. Par exemple :

   import math
   
   print(math.ceil(4.2))
   print(math.floor(4.8))
   print(math.pow(2, 3))

   Vous voyez ici trois usages fréquents : arrondir vers le haut, arrondir vers le bas et élever un nombre à une puissance. Le but est surtout de vous habituer à lire la documentation implicite d’un module à travers ses noms.

4. 4

   Importer seulement ce dont vous avez besoin

   Créez maintenant un second fichier nommé test_import_selectif.py. Essayez cette autre forme d’import :

   from math import sqrt, pi
   
   print(sqrt(36))
   print(pi)

   Dans cette version, vous utilisez directement sqrt et pi sans écrire math.. Cela peut alléger le code quand vous n’avez besoin que de quelques éléments précis.

5. 5

   Renommer un module avec as

   Testez maintenant un alias pour raccourcir l’écriture. Dans un nouveau fichier ou dans le même, écrivez :

   import math as m
   
   print(m.sqrt(49))
   print(m.pi)

   L’alias fonctionne comme un surnom pour le module. C’est pratique si un nom est long ou si vous voulez un style d’écriture plus compact.

6. 6

   Utiliser random pour générer un nombre simple

   Créez un fichier nommé test_random.py et importez random. Essayez ensuite un entier aléatoire :

   import random
   
   print(random.randint(1, 6))

   Cette ligne produit un entier compris entre 1 et 6. C’est un excellent premier exemple, car le résultat change d’une exécution à l’autre.

7. 7

   Choisir un élément au hasard

   

   Ajoutez une liste puis sélectionnez un élément avec choice. Par exemple :

   import random
   
   couleurs = ["rouge", "bleu", "vert"]
   print(random.choice(couleurs))

   Le module choisit ici un élément parmi ceux de la liste. Cette technique sert souvent à fabriquer de petits jeux, des quiz ou des messages variés.

8. 8

   Mélanger un mini programme avec math et random

   

   Regroupez maintenant les deux modules dans un exemple un peu plus vivant. Essayez ce script :

   import math
   import random
   
   nombre = random.randint(1, 100)
   racine = math.sqrt(nombre)
   
   print("Nombre :", nombre)
   print("Racine carrée :", racine)

   Ce mini programme montre qu’un même script peut importer plusieurs modules. Vous combinez ici une valeur aléatoire et un calcul mathématique sur cette valeur.

9. 9

   Créer votre premier module Python

   Créez un nouveau fichier nommé outils.py. Écrivez-y des fonctions simples :

   def dire_bonjour(nom):
       return "Bonjour " + nom
   
   def carre(nombre):
       return nombre * nombre

   Ce fichier devient votre propre module, car il contient du code réutilisable dans un autre script. Vous n’avez rien de spécial à ajouter : un simple fichier Python suffit pour commencer.

10. 10

    Importer votre module dans un second script

    Créez un fichier nommé utiliser_outils.py dans le même dossier que outils.py. Ajoutez ce code :

    import outils
    
    print(outils.dire_bonjour("Lina"))
    print(outils.carre(5))

    Exécutez ensuite ce second fichier. Python charge votre module personnel et vous laisse appeler ses fonctions comme avec math ou random.

11. 11

    Tester un import sélectif sur votre module

    Essayez enfin la forme sélective avec votre propre code. Modifiez le fichier d’utilisation ainsi :

    from outils import dire_bonjour, carre
    
    print(dire_bonjour("Lina"))
    print(carre(8))

    Vous appliquez exactement le même principe que pour math. Cette étape est importante, car elle montre que vos modules personnels suivent les mêmes règles d’usage que les modules standards.

Erreurs fréquentes & dépannage

L’erreur la plus fréquente consiste à oublier le préfixe du module après un import math classique. Si vous avez écrit import math, il faut appeler math.sqrt(...).

Un autre problème courant vient du nom des fichiers. Si votre fichier s’appelle random.py ou math.py, Python peut importer votre fichier au lieu du module attendu.

Enfin, si votre module personnel n’est pas trouvé, vérifiez que les deux fichiers sont dans le même dossier pour ce premier test. Contrôlez aussi l’orthographe du nom du fichier et du nom importé.

Astuces & pour aller plus loin

Créez un fichier par idée simple : un pour tester math, un pour random, puis un pour votre module personnel. Cette séparation aide à comprendre ce que chaque import apporte réellement.

Affichez souvent les résultats avec print() au début. C’est la manière la plus directe de vérifier que l’import fonctionne et que la fonction appelée renvoie bien ce que vous attendez.

Quand votre code grandit, placez les fonctions utiles dans un module séparé plutôt que de tout laisser dans un seul fichier. Vous relirez et réutiliserez votre travail plus facilement.

Questions fréquentes

À quoi sert un module en Python ?

Un module sert à regrouper du code réutilisable, comme des fonctions ou des valeurs. Vous pouvez l’importer dans un autre script au lieu de recopier le même code.

Quelle différence entre import math et from math import sqrt ?

Avec import math, vous appelez les éléments avec le préfixe math.. Avec from math import sqrt, vous utilisez directement sqrt sans préfixe.

Pourquoi mon module personnel n’est-il pas importé ?

Pour un premier essai, placez le fichier du module et le script qui l’utilise dans le même dossier. Vérifiez aussi que le nom du fichier correspond bien au nom écrit dans l’instruction import.

Puis-je créer un module avec un simple fichier .py ?

Oui, pour un cas débutant, un simple fichier .py contenant des fonctions suffit. Vous pouvez ensuite l’importer depuis un autre fichier Python.

Pourquoi éviter de nommer mon fichier math.py ou random.py ?

Parce que ces noms existent déjà pour des modules standards. Cela peut provoquer un import du mauvais fichier et rendre les erreurs difficiles à comprendre.

Conclusion

Vous savez maintenant importer un module, utiliser math et random, puis créer votre premier module personnel. Ce socle est essentiel, car il vous apprend à réutiliser du code au lieu de tout écrire dans un seul fichier.

La suite logique consiste à enrichir votre module outils.py avec de nouvelles fonctions simples. Plus vous pratiquez ces imports sur de petits scripts, plus la structure de vos programmes devient claire.