¿Mostrar las cadenas de documentación de Python para la función actual en Sublime Text 2?

Question

Acabo de encontrar Sublime Text 2 y es increíble. Lo único que echo de menos es la capacidad de ver la cadena de documentación de la función con la que estoy tratando. ¿Hay algún complemento que pueda hacer esto?

por ejemplo:

def f(x): 
    '''a doc string for f''' 
    print x 

f # << at this point, either automatically or with a keystroke, 
    # I would like to be able to somehow view "a doc string for f" 

Editar: ya he intentado usar SublimeCodeIntel y SublimeRope, ni tienen ese apoyo.

Edit2: También debería funcionar para otros módulos en el proyecto abierto.

Answer 1

Al ajustar SublimeCodeIntel, puede desactivar el "salto" al archivo donde se define la función: esto le permitirá ver la definición de la función en la barra de estado al hacer clic secundario.

Para ello, seleccione Preferencias > Buscar Paquetes y luego abrir SublimeCodeIntel/SublimeCodeIntel.py.

Ir a class GotoPythonDefinition(sublime_plugin.TextCommand): y añadir un return en la línea 890 de manera que las primeras líneas de _trigger lectura:

 def _trigger(defns): 
      if defns is not None: 
       defn = defns[0] 
       if defn.name and defn.doc: 
        msg = "%s: %s" % (defn.name, defn.doc) 
        logger(view, 'info', msg, timeout=3000) 
        return 

(también se puede modificar el formato de cadenas msg y retire la defn.name a ahorrar un poco de barra de estado espacio).

Es un poco desorientador tener que mirar hacia abajo en la barra de estado para ver la definición ... también, la barra de estado no podrá mostrar definiciones largas. Sin embargo, es un comienzo. Es de esperar que el control de información sobre herramientas/ventana emergente esté disponible a través de la API para que las definiciones puedan aparecer en la vista junto a las funciones de alt-clic.

Answer 2

Algo como this indicará el lugar correcto en la documentación, pero si realmente necesita documentación integrada en su entorno, consideraría usar un IDE. Sin embargo, yo también soy un fan de Sublime y simplemente abro un navegador cuando es necesario.