Discussion :

[Jackbalek]

Bonjour à tous.

Actuellement je souhaite générer une documentation de mon script en python avec Sphinx.
J'ai lu un tas de tuto là dessus, mais je ne vois pas encore comment générer automatiquement cette documentation à partir de mon script en python.

J'ai sphinx d'installé et pour l'instant j'obtiens la page html classique de sphinx.

J'ai lu quand faisant ainsi (voir ci dessous) cela pouvait fonctionner.

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
 
.. Homework documentation master file, created by
   sphinx-quickstart on Wed Jul 23 09:33:05 2014.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.
 
Welcome to Homework's documentation!
====================================
 
Contents:
 
.. toctree::
   :maxdepth: 2
 
.. automodule:: "nom de mon fichier"
 
.. autoclass:: "nom de mes classes"
 
Indices and tables
==================
 
* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`

Le problème que j'ai c'est que mon script en python ne possède pas de classe, mais uniquement des fonctions.
Et deuxième question comment la doc peut se générer sachant qu'à aucun moment je n'indique le path de mon script.

En espérant avoir été un maximum clair.
Je vous remercie d'avance.

[VinsS]

Salut,

Je ne l'ai jamais utiliser en autodoc, je préfère fournir la doc en .rst, mais la procédure est la même.

Tu crées dans ton appli un dossier doc, tu y mets ton fichier de config, tu ouvres une console dans ton appli et tu lance

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
 
sphinx-build -b html doc/ doc/_build/

Pour les classes, j'ignore comment ça se passe, mais rien ne t'empêche d'essayer en supprimer la ligne

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
 
.. autoclass:: "nom de mes classes"

du fichier de config.

[Jackbalek]

Merci pour cette réponse VinsS (et ce n'est pas la première).

Ce que je ne comprend pas, c'est où je place mon script. Doit-il rester dans un répertoire extérieur ou doit-je le mettre aussi dans le répertoire doc ?

[Petibidon]

Hello,

Ton script, tu le place un peu où tu veux. L'important c'est que sphinx puisse l'importer pour lire tes docstrings.
Pour cela tu dois éditer le fichier conf.py (qui doit se trouver dans ton dossier doc/source) et ajouter le chemin de ton script à sys.path. C'est la première directive après les imports, et le fichier conf.py est documenté pour te guider.

[Jackbalek]

Merci pour ta réponse, c'est bon j'ai trouvé.

Mais par contre je ne sais toujours pas comment faire pour générer automatiquement une doc.
A force de lire des tutos, j'ai l'impression que je vais devoir inclure une classe dans mon script (et ceci m'enchante que très peu...)

[Petibidon]

http://sphinx-doc.org/tutorial.html#autodoc

Pour ton script, automodule ou autofunction semblent pas mal adaptés