| 1 |
# SOME DESCRIPTIVE TITLE. |
| 2 |
# Copyright (C) 2023, DataLab Platform Developers |
| 3 |
# This file is distributed under the same license as the DataLab package. |
| 4 |
# FIRST AUTHOR <EMAIL@ADDRESS>, 2023. |
| 5 |
# |
| 6 |
#, fuzzy |
| 7 |
msgid "" |
| 8 |
msgstr "" |
| 9 |
"Project-Id-Version: DataLab \n" |
| 10 |
"Report-Msgid-Bugs-To: \n" |
| 11 |
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" |
| 12 |
"Language-Team: LANGUAGE <[email protected]>\n" |
| 13 |
"MIME-Version: 1.0\n" |
| 14 |
"Content-Type: text/plain; charset=utf-8\n" |
| 15 |
"Content-Transfer-Encoding: 8bit\n" |
| 16 |
"Generated-By: Babel 2.17.0\n" |
| 17 |
|
| 18 |
msgid "Coding guidelines" |
| 19 |
msgstr "Règles de codage" |
| 20 |
|
| 21 |
msgid "Generic coding guidelines" |
| 22 |
msgstr "Règles de codage génériques" |
| 23 |
|
| 24 |
msgid "We follow the `PEP 8 <https://www.python.org/dev/peps/pep-0008/>`_ coding style." |
| 25 |
msgstr "Nous suivons le style de codage `PEP 8 <https://www.python.org/dev/peps/pep-0008/>`_." |
| 26 |
|
| 27 |
msgid "In particular, we are especially strict about the following guidelines:" |
| 28 |
msgstr "En particulier, nous sommes particulièrement stricts sur les directives suivantes :" |
| 29 |
|
| 30 |
msgid "Limit all lines to a maximum of 79 characters." |
| 31 |
msgstr "Limiter toutes les lignes à un maximum de 79 caractères." |
| 32 |
|
| 33 |
msgid "Respect the naming conventions (classes, functions, variables, etc.)." |
| 34 |
msgstr "Respecter les conventions de nommage (classes, fonctions, variables, etc.)." |
| 35 |
|
| 36 |
msgid "Use specific exceptions instead of the generic :class:`Exception`." |
| 37 |
msgstr "Utiliser des exceptions spécifiques au lieu de :class:`Exception`." |
| 38 |
|
| 39 |
msgid "To enforce these guidelines, the following tools are mandatory:" |
| 40 |
msgstr "Pour faire respecter ces directives, les outils suivants sont obligatoires :" |
| 41 |
|
| 42 |
msgid "`ruff <https://pypi.org/project/ruff/>`_ for code formatting and static code analysis." |
| 43 |
msgstr "`ruff <https://pypi.org/project/ruff/>`_ pour le formatage du code et l'analyse statique du code." |
| 44 |
|
| 45 |
msgid "`pylint <https://pypi.org/project/pylint/>`_ for static code analysis." |
| 46 |
msgstr "`pylint <https://pypi.org/project/pylint/>`_ pour l'analyse statique du code." |
| 47 |
|
| 48 |
msgid "ruff" |
| 49 |
msgstr "ruff" |
| 50 |
|
| 51 |
msgid "If you are using `Visual Studio Code <https://code.visualstudio.com/>`_, the project settings will automatically format your code with `ruff` on save (you may also run the task \"Run Ruff\" to run `ruff` on the project)." |
| 52 |
msgstr "Si vous utilisez `Visual Studio Code <https://code.visualstudio.com/>`_, les paramètres du projet formateront automatiquement votre code avec `ruff` à l'enregistrement (vous pouvez également exécuter la tâche \"Run Ruff\" pour exécuter `ruff` sur le projet)." |
| 53 |
|
| 54 |
msgid "To run `ruff`, run the following command::" |
| 55 |
msgstr "Pour exécuter `ruff`, exécutez la commande suivante::" |
| 56 |
|
| 57 |
msgid "pylint" |
| 58 |
msgstr "pylint" |
| 59 |
|
| 60 |
msgid "To run `pylint`, run the following command::" |
| 61 |
msgstr "Pour exécuter `pylint`, exécutez la commande suivante::" |
| 62 |
|
| 63 |
msgid "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." |
| 64 |
msgstr "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." |
| 65 |
|
| 66 |
msgid "A `pylint` rating greater than 9/10 is required to merge a pull request." |
| 67 |
msgstr "Une note `pylint` supérieure à 9/10 est requise pour fusionner une demande d'extraction." |
| 68 |
|
| 69 |
msgid "Specific coding guidelines" |
| 70 |
msgstr "Règles de codage spécifiques" |
| 71 |
|
| 72 |
msgid "In addition to the generic coding guidelines, we have the following specific guidelines:" |
| 73 |
msgstr "En plus des directives de codage génériques, nous avons les directives spécifiques suivantes :" |
| 74 |
|
| 75 |
msgid "Write docstrings for all classes, methods and functions. The docstrings should follow the `Google style <https://google.github.io/styleguide/pyguide.html#s3.8-comments-and-docstrings>`_." |
| 76 |
msgstr "Écrire des docstrings pour toutes les classes, méthodes et fonctions. Les docstrings doivent suivre le `style Google <https://google.github.io/styleguide/pyguide.html#s3.8-comments-and-docstrings>`_." |
| 77 |
|
| 78 |
msgid "Add typing annotations for all functions and methods. The annotations should use the future syntax (``from __future__ import annotations``)" |
| 79 |
msgstr "Ajouter des annotations de typage pour toutes les fonctions et méthodes. Les annotations doivent utiliser la syntaxe future (``from __future__ import annotations``)" |
| 80 |
|
| 81 |
msgid "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." |
| 82 |
msgstr "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." |
| 83 |
|
| 84 |
msgid "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." |
| 85 |
msgstr "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." |
| 86 |
|
| 87 |
msgid "Do not use ``from module import *`` statements, even in the ``__init__`` module of a package." |
| 88 |
msgstr "N'utilisez pas d'instructions ``from module import *``, même dans le module ``__init__`` d'un package." |
| 89 |
|
| 90 |
msgid "Avoid using mixins (multiple inheritance) when possible. It is often possible to use composition instead of inheritance." |
| 91 |
msgstr "Évitez d'utiliser des mixins (héritage multiple) si possible. Il est souvent possible d'utiliser la composition au lieu de l'héritage." |
| 92 |
|
| 93 |
msgid "Avoid using ``__getattr__`` and ``__setattr__`` methods. They are often used to implement lazy initialization, but this can be done in a more explicit way." |
| 94 |
msgstr "É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." |