wikinotes

Outils pour utilisateurs

Outils du site

Piste : • pip • mqtt • tcl-tk • pygtk • logging • unittest • conception-interfaces-graphiques • sqlalchemy • bonnes-pratiques
dev:python:bonnes-pratiques

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision		Révision précédente
dev:python:bonnes-pratiques [2020/11/18 19:14] – yoanndev:python:bonnes-pratiques [2021/02/01 21:51] (Version actuelle) – modification externe 127.0.0.1
Ligne 15: Ligne 15:
 Cet usage syntaxique de l' indentation peut paraître déconcertant pour ceux connaissent d'autres langages puisqu'en général les syntaxes des langages sont conçues de manière à être insensibles aux espaces et à la présentation. Cet usage syntaxique de l' indentation peut paraître déconcertant pour ceux connaissent d'autres langages puisqu'en général les syntaxes des langages sont conçues de manière à être insensibles aux espaces et à la présentation.
 </note> </note>
 +
 +===== Conventions d'usage =====
 +
 +Non obligatoires mais fortement recommandées pour s'assurer de la lisibilité et de l’homogénéité du code produit respectant les bonnes pratiques mises en avant dans les modules standards.
 +
 +<code python>
 +# aérer affectations et opérations
 +x = y + z
 +
 +#définition de fonction
 +def ma_fonction(x, y, z):
 +
 +# appel de fonction avec de nombreux arguments
 +x = ma_fonction_avec_un_nom_log(
 +        arg1, arg2,
 +        arg3, arg4,
 +    )
 +</code>
 +
 +Quand c'est nécessaire, le backslash permet d'échapper le caractère de retour à la ligne et de répartir l'instruction sur plusieurs lignes. Lorsqu' une instruction est répartie sur plusieurs lignes, c'est naturellement l'indentation de la première ligne qui est significative pour savoir à quel bloc rattacher cette instruction.
 +
 +L'outil pep8 permet de vérifier si le code produit est conforme à la PEP0008.
 +
  
 ===== Documentation ===== ===== Documentation =====
Ligne 24: Ligne 47:
 Intégrer les getters/setters avec la méthode **property** afin de faciliter l'utilisation Intégrer les getters/setters avec la méthode **property** afin de faciliter l'utilisation
  
 +===== Indices =====
 +
 +Vous devez toujours garder en tête qu'il est rare en Python de manipuler des indices. Dès que vous voyez des indices dans votre code, vous devez vous demander si votre code est "pythonique".
  
 ===== Références ===== ===== Références =====
dev/python/bonnes-pratiques.1605726853.txt.gz · Dernière modification : 2021/02/01 21:51 (modification externe)

Outils de la page

Sauf mention contraire, le contenu de ce wiki est placé sous les termes de la licence suivante : GNU Free Documentation License 1.3
GNU Free Documentation License 1.3 Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki