L'objectif : Dans le cadre d'un projet Python, nous souhaitons documenter proprement de code.
Comme exemple nous considérerons que nous avons codé une classe Sample dans sample.py :
01: class Sample:
02: """
03: Classe d'exemple pour Sphinx
04: """
05:
06: def __init__(self, name):
07: """
08: Constructeur de la classe
09:
10: :param name: Nom de l'objet
11: :type name: string
12:
13: :return: Objet Sample
14: :rtype: Sample
15: …
- Accédez à tous les contenus de Connect en illimité
- Découvrez des listes de lecture et des contenus Premium
- Consultez les nouveaux articles en avant-première