cours-python/cours/source/11-modules-01/index.rst

Introduction aux modules
========================

Un fichier = un module
------------------------

Et oui, vous faites des modules sans le savoir depuis le début :)

Un fichier `foo.py` correspond *toujours* module `foo`

**Attention: Ce n'est pas tout à fait réciproque. Le module `foo` peut venir d'autre chose
qu'un fichier foo.py.**

Importer un module
------------------

Ou: accéder à du code provenant d'un *autre* fichier source.

Créons un fichier `bonjour.py` contenant seulement une assignation
d'une variable `a` à l'entier 42 ::

    # Dans bonjour.py
    a = 42

Comme un fichier = un module, on vient de crée un module ``bonjour`` contenant une variable ``a``.

Si maintenant on crée un fichier ``salutations.py`` dans le même répertoire,
on peut accéder à cette variable en *important* le module::

    # Dans salutations.py
    import bonjour
    print(bonjour.a)
    # affiche: 42


.. note::

  Le nom du module est écrit directement, ce n'est *pas* une
  chaîne de caractères.

On voit que l'assignation de la variable `a` dans `bonjour.py` est devenue
un *attribut* du module `bonjour` lorsque `bonjour` a été importé


Si maintenant on rajoute une fonction ``dire_bonjour`` dans ``bonjour.py``::

    # Dans bonjour.py
    a = 42
    def dire_bonjour():
        print("Bonjour!")

On peut appeler la fonction ``dire_bonjour`` depuis ``salutations.py``
en utilisant l'attribut ``dire_bonjour`` du module ``bonjour``::

   # Dans salutations.py
   import bonjour
   bonjour.dire_bonjour()
   # affiche: Bonjour!

Les imports ne sont faits qu'une seule fois
-------------------------------------------

Il est important de noter que:

* **tout** le code à l'intérieur d'un module est éxécuté lors du premier import
* mais il n'est *pas* ré-éxécuté si le module a déjà été importé auparavant.

On peut le voir en mettant du code dans `bonjour.py`,
en plus des simples définitions de fonctions et assignations
de variables::

    # Dans bonjour.py
    print("Je suis le module bonjour et tu viens de m’importer")
    def dire_bonjour():
        ....

.. code-block:: python

    # Dans salutation.py
    import bonjour
    # affiche: Je suis le module bonjour et tu viens de m’importer

    import bojour
    # n'affiche rien


La bibliothèque standard
------------------------

La bibliothèque standard est une collection de modules directement utilisables fournis à l'installation de Python.

Exemple: ``sys``, ``random``, ...

Toute la bibliothèque standard est documentée - et la traduction en Français est en cours:

https://docs.python.org/fr/3/library/index.html

Mettez ce lien dans vos favoris - il vous sera très utile.

Quelques exemples de modules de la bibliothèque standard
---------------------------------------------------------

Easter eggs
++++++++++++

(Ou fonctionnalités cachées)

* ``import antigravity``
* ``import this``

Je vous laisse découvrir ce que fait le premier. Quant au deuxième, il contient
une liste de préceptes que la plupart des développeurs Python s'efforcent de
respecter. On en reparlera ...