Outils pour utilisateurs

Outils du site


dev:python:bonnes-pratiques

Ceci est une ancienne révision du document !


Bonnes pratiques

Duck typing

La l'oie du canard: If it looks like a duck and quacks like a duck, it must be a duck.

Dans la majorité des cas il importe peu que l'objet soit une instance d'un type particulier, on cherche à savoir s'il a le bon comportement. On privilégiera donc l'emploie de hasattr() au lieu de isinstance().

Mise en forme

Limiter la longueur des lignes à 80 caractères. En python tout ce qui est entre parenthèses, crochets ou accolades supporte le retour à la ligne sans créer de problème dans la syntaxe python. L'indentation est primordiale car elle participe à la syntaxe: elle délimite les blocs d'instructions. Par convention chaque niveau d'indentation est de 4 caractères espace.

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.

Documentation

Python à un mécanisme interne permettant d'intégrer la documentation au code. Utiliser les doc-strings (triples apostrophes) pour produire la documentation directement dans le code et la rendre disponible dans l'interpréteur.

getters/setters

Intégrer les getters/setters avec la méthode property afin de faciliter l'utilisation

Références

dev/python/bonnes-pratiques.1605726853.txt.gz · Dernière modification : 2021/02/01 21:51 (modification externe)