Les modules, fonctions et objets
================================

L'objectifs de ces "méthodes" est d'optimiser et améliorer les programmes que vous allez développer. Il convient donc de prendre, dès à présent, de
bonnes habitudes. 

.. tip::

    Toujours documenter le code. Cela permet de mieux comprendre et de mieux se faire comprendre.

Modules
-------

Exploiter un module
^^^^^^^^^^^^^^^^^^^

.. code:: python

    >>> import math             # Importe le module math
    >>> dir(math)               # Affiche toutes les fonctions incluses dans math
    >>> print(math.pi)          # Affiche le contenu de la variable pi déclarée dans le module math
    3.141592653589793
    >>> print(math.log(10))     # Affiche le résultat de log(10)
    2.302585092994046

    >>> from math import log    # N'importe que la fonction log du module math
    >>> print(pi)
    Traceback (most recent call last):
    File "<stdin>", line 1, in <module>
    NameError: name 'pi' is not defined
    >>> print(math.pi)
    Traceback (most recent call last):
    File "<stdin>", line 1, in <module>
    NameError: name 'math' is not defined
    >>> print(log(10))
    2.302585092994046

Fonctions
---------

Une fonction sert à structurer le code en regroupant les fonctionnalités du programme. Pour déclarer une fonction, on utilise ``def``.

.. code:: python

    >>> def Hello() -> None:            # Déclare la fonction Hello. Il n'y a pas de paramètres d'entrée. Il n'y a pas de résultats en sortie.
    ...    print('Bonjour!!!')
    >>> Hello()                         # Appelle la fonction ``Hello``
    Bonjour !!!
    >>> def Hello(msg:str) -> None:     # Déclare la fonction Hello. Il y a un paramètre d'entrée (msg de type string). Il n'y a pas de résultats en sortie.
    ...     print(msg)
    >>> Hello('World...')
    World...

Objets
------