forked from VimPlug/jedi
145 lines
3.6 KiB
Python
145 lines
3.6 KiB
Python
import pydoc
|
|
import keyword
|
|
|
|
from jedi._compatibility import is_py3, is_py35
|
|
from jedi.evaluate.utils import ignored
|
|
from jedi.evaluate.filters import AbstractNameDefinition
|
|
from parso.python.tree import Leaf
|
|
|
|
try:
|
|
from pydoc_data import topics as pydoc_topics
|
|
except ImportError:
|
|
# Python 2
|
|
try:
|
|
import pydoc_topics
|
|
except ImportError:
|
|
# This is for Python 3 embeddable version, which dont have
|
|
# pydoc_data module in its file python3x.zip.
|
|
pydoc_topics = None
|
|
|
|
if is_py3:
|
|
if is_py35:
|
|
# in python 3.5 async and await are not proper keywords, but for
|
|
# completion pursposes should as as though they are
|
|
keys = keyword.kwlist + ["async", "await"]
|
|
else:
|
|
keys = keyword.kwlist
|
|
else:
|
|
keys = keyword.kwlist + ['None', 'False', 'True']
|
|
|
|
|
|
def has_inappropriate_leaf_keyword(pos, module):
|
|
relevant_errors = filter(
|
|
lambda error: error.first_pos[0] == pos[0],
|
|
module.error_statement_stacks)
|
|
|
|
for error in relevant_errors:
|
|
if error.next_token in keys:
|
|
return True
|
|
|
|
return False
|
|
|
|
|
|
def completion_names(evaluator, stmt, pos, module):
|
|
keyword_list = all_keywords(evaluator)
|
|
|
|
if not isinstance(stmt, Leaf) or has_inappropriate_leaf_keyword(pos, module):
|
|
keyword_list = filter(
|
|
lambda keyword: not keyword.only_valid_as_leaf,
|
|
keyword_list
|
|
)
|
|
return [keyword.name for keyword in keyword_list]
|
|
|
|
|
|
def all_keywords(evaluator, pos=(0, 0)):
|
|
return set([Keyword(evaluator, k, pos) for k in keys])
|
|
|
|
|
|
def keyword(evaluator, string, pos=(0, 0)):
|
|
if string in keys:
|
|
return Keyword(evaluator, string, pos)
|
|
else:
|
|
return None
|
|
|
|
|
|
def get_operator(evaluator, string, pos):
|
|
return Keyword(evaluator, string, pos)
|
|
|
|
|
|
keywords_only_valid_as_leaf = (
|
|
'continue',
|
|
'break',
|
|
)
|
|
|
|
|
|
class KeywordName(AbstractNameDefinition):
|
|
api_type = 'keyword'
|
|
|
|
def __init__(self, evaluator, name):
|
|
self.evaluator = evaluator
|
|
self.string_name = name
|
|
self.parent_context = evaluator.BUILTINS
|
|
|
|
def eval(self):
|
|
return set()
|
|
|
|
def infer(self):
|
|
return [Keyword(self.evaluator, self.string_name, (0, 0))]
|
|
|
|
|
|
class Keyword(object):
|
|
api_type = 'keyword'
|
|
|
|
def __init__(self, evaluator, name, pos):
|
|
self.name = KeywordName(evaluator, name)
|
|
self.start_pos = pos
|
|
self.parent = evaluator.BUILTINS
|
|
|
|
@property
|
|
def only_valid_as_leaf(self):
|
|
return self.name.value in keywords_only_valid_as_leaf
|
|
|
|
@property
|
|
def names(self):
|
|
""" For a `parsing.Name` like comparision """
|
|
return [self.name]
|
|
|
|
def py__doc__(self, include_call_signature=False):
|
|
return imitate_pydoc(self.name.string_name)
|
|
|
|
def __repr__(self):
|
|
return '<%s: %s>' % (type(self).__name__, self.name)
|
|
|
|
|
|
def imitate_pydoc(string):
|
|
"""
|
|
It's not possible to get the pydoc's without starting the annoying pager
|
|
stuff.
|
|
"""
|
|
if pydoc_topics is None:
|
|
return ''
|
|
|
|
# str needed because of possible unicode stuff in py2k (pydoc doesn't work
|
|
# with unicode strings)
|
|
string = str(string)
|
|
h = pydoc.help
|
|
with ignored(KeyError):
|
|
# try to access symbols
|
|
string = h.symbols[string]
|
|
string, _, related = string.partition(' ')
|
|
|
|
get_target = lambda s: h.topics.get(s, h.keywords.get(s))
|
|
while isinstance(string, str):
|
|
string = get_target(string)
|
|
|
|
try:
|
|
# is a tuple now
|
|
label, related = string
|
|
except TypeError:
|
|
return ''
|
|
|
|
try:
|
|
return pydoc_topics.topics[label].strip() if pydoc_topics else ''
|
|
except KeyError:
|
|
return ''
|