Modifications

== Les paquets (Packages) ==

== Les paquets (Packages) ==

Sometimes your code can get so complex that putting it into a single file doesn't make sense.  In these cases you can break code into multiple files and create a Python package that puts all the code together into what looks like a simple module your scripts can import.  MicroPython supports the concept of Python packages just like normal Python so you can better structure complex scripts.

Il arrive parfois que votre code devienne tellement complexe que le placer dans un unique fichier à importer n'a pas, non plus, beaucoup de sens!

First be sure to read the [https://docs.python.org/3/tutorial/modules.html#packages official documentation on Python packages]. Packages in MicroPython for the most part work just the same as in Python.

Dans ce cas, vous pouvez scinder votre code en plusieurs fichiers et créer ce que l'on appelle un "''Package''" Python ("''package''" est un terme anglais que l'on traduit généralement par "''paquet''"). Les Package/Paquet rassemble tout le code ensemble en quelque-chose qui à un simple module que vos scripts peuvent importer. MicroPython supporte le concept de Package/Paquet Python comme le language Python standardiser. L'utilisation des Paquets/Packages permet d'offrir une meilleure structure à vos scripts et projets vraiment complexes.

Now create a Python package on your computer by creating a directory called '''test'''. Inside that directory create a file called '''add.py''' and place inside it the add function code:

Avant tout, assurez-vous d'avoir pris connaissance de la [https://docs.python.org/3/tutorial/modules.html#packages documentation officielle des packages/paquets Python] (''python.ord, anglais''). les Paquets/Packages en MicroPython fonctionne, pour la plupart des cas, de la même façon qu'en Python.

 

Nous allons maintenant créer un paquet/package Python sur notre ordinateur. Créez un répertoire appelé '''test''' et ajoutez le fichier '''add.py''' à l'intérieur de celui-ci.  

 

Dans le fichier '''add.py''', ajoutez la fonction {{fname|add}} tel que déclarée ci-dessous:

  <syntaxhighlight lang="python">

  <syntaxhighlight lang="python">

  </syntaxhighlight>

  </syntaxhighlight>

Create a file '''subtract.py''' in the same location and place in it the subtract function code:

Créez aussi un fichier '''subtract.py''' dans le même emplacement et ajouter la fonction {{fname|substract}} tel que déclarée ci-dessous:

  <syntaxhighlight lang="python">

  <syntaxhighlight lang="python">

  </syntaxhighlight>

  </syntaxhighlight>

   

   

Finally create a file called '''__init__.py''' in the same location and enter the following code to import and expose the functions from the files above:

Pour finir, créez un fichiez appelé '''__init__.py''' dans le même emplacement. Saisissez y le code suivant pour importer et exposer les fonctions des deux fichiers add.py et substract.py précédemment crées:

  <syntaxhighlight lang="python">

  <syntaxhighlight lang="python">

from test.subtract import subtract

from test.subtract import subtract

  </syntaxhighlight>

  </syntaxhighlight>

'''Be sure to call this file exactly __init__.py'''!  Python looks for this file name to know that it found a package.  If you don't have this file or if it's not named correctly then Python will fail to import the package!

'''Be sure to call this file exactly __init__.py'''!  Python looks for this file name to know that it found a package.  If you don't have this file or if it's not named correctly then Python will fail to import the package!