Jedi - Python 自动完成（提示）不显示方法或建议

Question

我目前正在开发 Sublime Text 3 使用 Jedi - Python 自动完成功能，具体来说，它适用于最基本的东西。 但是我在这种情况下使用它就像在 BeautifulSoup4 中一样

主要问题是，在执行多个点 (.) 方法时无法正确显示补全在一个文件上，完成者必须首先像 .find_all 方法一样看到它，然后它会建议它（但这似乎是 Sublime Text 3 本身的自动完成）。

接下来会发生什么

import requests
from bs4 import BeautifulSoup as Soup // works ok, shows all suggestions

request = requests.get('http://example.com')    
soup = Soup(request.text, 'lxml')


main = soup.find('body') // shows find method 
//However, No available completions in the next case
second_lookup = main.find('div') // doesn't show any autocompletions/hints when starting w/ .fi..

在寻找任何其他“更深入”的自动完成方法时也是如此。到目前为止，我已经尝试调整 Jedi..settings 文件中的所有设置。这没有帮助，我尝试使用 Anaconda，因为它还有一些额外的工具，包括 Jedi。

这似乎特定于某些库，例如 numpy 和 bs4。

注意：

这并非特定于 Sublime Text 3。 Atom 和类似的 IDEs 也是如此。

Answer 1

Python 是一种动态语言。函数或方法的参数完全依赖于docstrings 的类型规范。返回类型也是如此。

例如，这是requests 模块的get 函数的docstring（或文档）：

def get(url, params=None, **kwargs):
    r"""Sends a GET request.

    :param url: URL for the new :class:`Request` object.
    :param params: (optional) Dictionary, list of tuples or bytes to send
        in the query string for the :class:`Request`.
    :param \*\*kwargs: Optional arguments that ``request`` takes.
    :return: :class:`Response <Response>` object
    :rtype: requests.Response
    """

    kwargs.setdefault('allow_redirects', True)
    return request('get', url, params=params, **kwargs)

返回类型在函数定义中指定。您还可以指定函数的参数类型。

但是Soup类的find方法是这样写的：

def find(self, name=None, attrs={}, recursive=True, text=None,
         **kwargs):
    """Return only the first child of this Tag matching the given
    criteria."""
    r = None
    l = self.find_all(name, attrs, recursive, text, 1, **kwargs)
    if l:
        r = l[0]
    return r

编辑器可以查找Soup类的find方法。但是，他们不知道这个方法返回什么类型的对象。

---

分配给变量时，解决方法是specify type：

import requests
from bs4 import Tag
from bs4 import BeautifulSoup as Soup

request = requests.get('http://example.com')

soup = Soup(request.text, 'lxml')

main: Tag  = soup.find('body')

# Auto completion works.
second_lookup = main.find('div')

或者您可以将:rtype: Tag 添加到find 文档字符串。我知道它返回Tag 对象，因为type(main) 或type(second_lookup) 都返回<class 'bs4.element.Tag'>。

我提供的链接足以让您了解 Python 中的静态类型并完美记录您的代码。希望这可以帮助。