2011-09-21 13 views
5

En el momento en que estoy documentando mucho de mi código (Python) y me preguntaba si existe un complemento para Eclipse que pueda generar automáticamente una cadena de documentación para mis funciones, al igual que Visual Studio lo hace para C# al escribir /// sobre un método.Autogenerar documentación ficticia en el código fuente de Python en eclipse

He estado buscando una solución, pero no he tenido suerte. ¿Alguno de ustedes conoce una solución?

Ejemplo:

Desde mi lista de parámetros en un método de la documentación "de prueba" se creará en mi definición de un método como se muestra a continuación:

def myFunction(self, a, b): 
    """ 

    :param a: 
    :type a: 
    :param b: 
    :type b: 
    :return: 
    :rtype: 
    """ 
    return 'Hello, world' 
+0

creo que esto está en contra, en general, del espíritu de pitón. Los parámetros deben auto documentarse a través de su posible nombre detallado. Python utiliza la inferencia de tipo, por lo tanto, una prueba de unidad debe fallar si el tipo de argumento no coincide con el tipo de parámetro deseado. Una documentación de una línea debería ser suficiente. –

+0

De muchas maneras estoy de acuerdo con usted, sin embargo, no creo que mi usuario final lo haga. Él no tiene acceso a las pruebas unitarias, y creo que un buen código documentado que elabore un poco más que los nombres de mis parámetros hacen su vida más fácil y puede comenzar a usar mi API un poco más rápido. (y con menos costos) – aweis

+0

Veo su punto, pero dejaría la información del tipo. –

Respuesta

6

Bueno, según this doc, si presione Ctrl + en un nombre de método, obtendrá lo que necesita.

Para su ejemplo (EDIT: si se establece la opción PyDev> Editor> Estilo de Código> Las cadenas de documentación> generación Doctag para siempre para obtener el tipo del parámetro), obtendrá:

def myFunction(self, a, b): 
    ''' 

    @param a: 
    @type a: 
    @param b: 
    @type b: 
    ''' 
    return 'Hello, world' 
+0

No he encontrado eso, pero está muy cerca :) y puedo ver que en mis preferencias en Eclipse puedo cambiar el single-qoute por el doble, pero, debido a mi herramienta de documentación (Sphinx), la '@' debe estar cambiado a ':' para que funcione, ¡pero realmente no puedo ver si eso es posible! – aweis

+0

@aweis: Encontré cómo agregar el tipo del parámetro (aún no sé cómo cambiar el @ en :) –

+0

Hola, de alguna manera ya no tengo el tipo, ¿qué hiciste para que eso también se genere automáticamente? - Si también obtengo el parámetro type, puedo vivir con el hecho de que necesito cambiar manualmente @ @ s – aweis

Cuestiones relacionadas