28.06.2017 Views

Python para todos

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

Documentación<br />

epydoc ejemplo.py<br />

o bien<br />

epydoc --html ejemplo.py<br />

Para generar un archivo PDF, utilizando LaTeX, se utilizaría el flag<br />

--pdf:<br />

epydoc --pdf ejemplo.py<br />

Si LaTeX no está instalado o epydoc no encuentra el ejecutable no será<br />

posible generar el PDF.<br />

También podemos indicar el nombre del proyecto y la URL mediante<br />

las opciones --name y --url:<br />

epydoc --name Ejemplo --url http://mundogeek.net ejemplo.py<br />

E incluso añadir diagramas mostrando la clase base y subclases<br />

(--graph classtree), las llamadas entre funciones y mé<strong>todos</strong> (--graph<br />

callgraph), clases y subclases usando notación UML (--graph umlclasstree)<br />

o <strong>todos</strong> ellos (--graph all).<br />

epydoc --graph all ejemplo.py<br />

Para generar el grafo de llamadas, no obstante, es necesario generar<br />

un archivo con la información necesaria utilizando el módulo profile<br />

o el módulo hotshot e indicar el archivo resultante utilizando el flag<br />

--pstat:<br />

epydoc --graph all --pstat profile.out ejemplo.py<br />

Veamos ahora algunas funcionalidades básicas de marcado en reStructuredText.<br />

Para poner un texto en itálica se rodea el texto con asteriscos:<br />

*itálica* -> itálica<br />

129

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!