在Sublime Text 2中显示当前函数的Python doc字符串？

Question

我刚刚找到了Sublime Text 2,它真棒.我唯一真正想念的是能够查看我正在处理的函数的doc字符串.有没有可以做到这一点的插件？

例如:

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"

编辑:我已经尝试过使用SublimeCodeIntel和SublimeRope,都没有这样的支持.

Edit2:它也应该适用于打开项目中的其他模块.

Answer 1

通过调整 SublimeCodeIntel，您可以禁用“跳转”到定义函数的文件——这将允许您在按住 Alt 键单击时在状态栏中看到函数定义。

为此，请选择“首选项”>“浏览包”，然后打开 SublimeCodeIntel/SublimeCodeIntel.py。

转到第 890 行class GotoPythonDefinition(sublime_plugin.TextCommand):并添加一个，return以便第一行读取_trigger：

        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

（您还可以调整msg字符串格式并删除defn.name以节省一些状态栏空间）。

必须低头看状态栏才能看到定义，这有点迷失方向……而且，状态栏无法显示长定义。然而，这是一个开始。希望可以通过 API 提供工具提示/弹出窗口控制，以便定义可以出现在按住 Alt 键单击的函数旁边的视图中。