DataLab - en to fr translation catalogue (27 entries)

en: Coding guidelines
fr: Règles de codage

en: Generic coding guidelines
fr: Règles de codage génériques

en: We follow the `PEP 8 <https://www.python.org/dev/peps/pep-0008/>`_ coding style.
fr: Nous suivons le style de codage `PEP 8 <https://www.python.org/dev/peps/pep-0008/>`_.

en: In particular, we are especially strict about the following guidelines:
fr: En particulier, nous sommes particulièrement stricts sur les directives suivantes :

en: Limit all lines to a maximum of 79 characters.
fr: Limiter toutes les lignes à un maximum de 79 caractères.

en: Respect the naming conventions (classes, functions, variables, etc.).
fr: Respecter les conventions de nommage (classes, fonctions, variables, etc.).

en: Use specific exceptions instead of the generic :class:`Exception`.
fr: Utiliser des exceptions spécifiques au lieu de :class:`Exception`.

en: To enforce these guidelines, the following tools are mandatory:
fr: Pour faire respecter ces directives, les outils suivants sont obligatoires :

en: `black <https://pypi.org/project/black/>`_ for code formatting.
fr: `black <https://pypi.org/project/black/>`_ pour le formatage du code.

en: `isort <https://pypi.org/project/isort/>`_ for import sorting.
fr: `isort <https://pypi.org/project/isort/>`_ pour le tri des importations.

en: `pylint <https://pypi.org/project/pylint/>`_ for static code analysis.
fr: `pylint <https://pypi.org/project/pylint/>`_ pour l'analyse statique du code.

en: If you are using `Visual Studio Code <https://code.visualstudio.com/>`_, the project settings will automatically format your code on save.
fr: Si vous utilisez `Visual Studio Code <https://code.visualstudio.com/>`_, les paramètres du projet formateront automatiquement votre code lors de l'enregistrement.

en: Or you may use `black` manually. To format your code, run the following command::
fr: Ou vous pouvez utiliser `black` manuellement. Pour formater votre code, exécutez la commande suivante::

en: Again, if you are using `Visual Studio Code <https://code.visualstudio.com/>`_, the project settings will automatically sort your imports on save.
fr: Encore une fois, si vous utilisez `Visual Studio Code <https://code.visualstudio.com/>`_, les paramètres du projet trieront automatiquement vos importations lors de l'enregistrement.

en: Or you may use `isort` manually. To sort your imports, run the following command::
fr: Ou vous pouvez utiliser `isort` manuellement. Pour trier vos importations, exécutez la commande suivante::

en: To run `pylint`, run the following command::
fr: Pour exécuter `pylint`, exécutez la commande suivante::

en: If you are using `Visual Studio Code <https://code.visualstudio.com/>`_ on Windows, you may run the task "Run Pylint" to run `pylint` on the project.
fr: Si vous utilisez `Visual Studio Code <https://code.visualstudio.com/>`_ sur Windows, vous pouvez exécuter la tâche "Run Pylint" pour exécuter `pylint` sur le projet.

en: A `pylint` rating greater than 9/10 is required to merge a pull request.
fr: Une note `pylint` supérieure à 9/10 est requise pour fusionner une demande d'extraction.

en: Specific coding guidelines
fr: Règles de codage spécifiques

en: In addition to the generic coding guidelines, we have the following specific guidelines:
fr: En plus des directives de codage génériques, nous avons les directives spécifiques suivantes :

en: Write docstrings for all classes, methods and functions. The docstrings should follow the `Google style <http://google-styleguide.googlecode.com/svn/trunk/pyguide.html?showone=Comments#Comments>`_.
fr: Écrire des docstrings pour toutes les classes, méthodes et fonctions. Les docstrings doivent suivre le `style Google <http://google-styleguide.googlecode.com/svn/trunk/pyguide.html?showone=Comments#Comments>`_.

en: Add typing annotations for all functions and methods. The annotations should use the future syntax (``from __future__ import annotations``)
fr: Ajouter des annotations de typage pour toutes les fonctions et méthodes. Les annotations doivent utiliser la syntaxe future (``from __future__ import annotations``)

en: Try to keep the code as simple as possible. If you have to write a complex piece of code, try to split it into several functions or classes.
fr: Essayez de garder le code aussi simple que possible. Si vous devez écrire un morceau de code complexe, essayez de le diviser en plusieurs fonctions ou classes.

en: Add as many comments as possible. The code should be self-explanatory, but it is always useful to add some comments to explain the general idea of the code, or to explain some tricky parts.
fr: Ajouter autant de commentaires que possible. Le code doit être auto-explicatif, mais il est toujours utile d'ajouter des commentaires pour expliquer l'idée générale du code, ou pour expliquer certaines parties délicates.

en: Do not use ``from module import *`` statements, even in the ``__init__`` module of a package.
fr: N'utilisez pas d'instructions ``from module import *``, même dans le module ``__init__`` d'un package.

en: Avoid using mixins (multiple inheritance) when possible. It is often possible to use composition instead of inheritance.
fr: Évitez d'utiliser des mixins (héritage multiple) si possible. Il est souvent possible d'utiliser la composition au lieu de l'héritage.

en: Avoid using ``__getattr__`` and ``__setattr__`` methods. They are often used to implement lazy initialization, but this can be done in a more explicit way.
fr: Évitez d'utiliser les méthodes ``__getattr__`` et ``__setattr__``. Ils sont souvent utilisés pour implémenter une initialisation paresseuse, mais cela peut être fait de manière plus explicite.
