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

Chapitre 12 - Modules - 1ère partie
===================================

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.

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

    # Dans bonjour.py
    a = 42

On peut accéder à cette variable en important le module, par
exemple depuis l'interpréteur, en utilisant le mot-clé `import`
suivi du nom du module::

    $ python
    >>> import bonjour
    >>> bonjour.a
    42

Notez que pour que cela fonctionne:

* Le nom du module est écrit directement, ce n'est *pas* une
  chaîne de caractères.
* Il faut lancer la commande `python` sans argument
* Il faut la lancer depuis le répertoire qui contient `bonjour.py`.

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``::

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

On peut appeler la fonction ``dire_bonjour`` depuis l'interpréteur en accédant
à l'attribut ``dire_bonjour`` du module ``bonjour``::

   >>> import bonjour
   >>> bonjour.dire_bonjour()
   Bonjour!

Différence avec la commande python
-----------------------------------

Notez bien que lancer l'interpréteur et taper `import bonjour` dedans n'est pas
la même chose que lancer `python bonjour.py`.

Dans le deuxième cas, tout le code dans `bonjour.py` est exécuté, puis la commande python
se termine.

Dans le cas de l'interpréteur, on peut utiliser tous les attributs du module et appeler
les fonctions autant de fois qu'on veut::

    >>> import bonjour
    >>> bonjour.dire_bonjour()
    Bonjour!
    >>> bonjour.dire_bonjour()
    Bonjour!

On peut aussi modifier les valeurs des attributs::

    >>> import bonjour
    >>> bonjour.a
    42
    >>> bonjour.a = 36
    >>> bonjour.a
    36


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

Il est important de noter que le code à l'intérieur d'un
module 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")

    >>> import bonjour
    Je suis le module foo et tu viens de m’importer
    >>> import bonjour
    <rien>

Il faudra donc redémarrer l'interpréteur à chaque fois que le code dans `bonjour.py` change.

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