""" Basically a parser that is faster, because it tries to parse only parts and if anything changes, it only reparses the changed parts. But because it's not finished (and still not working as I want), I won't document it any further. """ import re from itertools import chain from jedi._compatibility import use_metaclass, unicode from jedi import settings from jedi.parser import Parser from jedi.parser import tree as pr from jedi.parser import tokenize from jedi import cache from jedi import debug from jedi.parser.tokenize import (source_tokens, NEWLINE, ENDMARKER, INDENT, DEDENT) FLOWS = ['if', 'else', 'elif', 'while', 'with', 'try', 'except', 'finally', 'for'] class FastModule(pr.SubModule): type = 'file_input' def __init__(self, module_path): super(FastModule, self).__init__([]) self.modules = [] self.reset_caches() self.names_dict = {} self.path = module_path def reset_caches(self): self.modules = [] try: del self._used_names # Remove the used names cache. except AttributeError: pass # It was never used. @property @cache.underscore_memoization def used_names(self): """ used_names = {} for m in self.modules: for k, statement_set in m.used_names.items(): if k in used_names: used_names[k] |= statement_set else: used_names[k] = set(statement_set) """ return MergedNamesDict([m.used_names for m in self.modules]) @property def global_names(self): return [name for m in self.modules for name in m.global_names] @property def error_statement_stacks(self): return [e for m in self.modules for e in m.error_statement_stacks] def __repr__(self): return "" % (type(self).__name__, self.name, self.start_pos[0], self.end_pos[0]) # To avoid issues with with the `parser.Parser`, we need setters that do # nothing, because if pickle comes along and sets those values. @global_names.setter def global_names(self, value): pass @error_statement_stacks.setter def error_statement_stacks(self, value): pass @used_names.setter def used_names(self, value): pass class MergedNamesDict(object): def __init__(self, dicts): self.dicts = dicts def __iter__(self): return iter(set(key for dct in self.dicts for key in dct)) def __getitem__(self, value): return list(chain.from_iterable(dct.get(value, []) for dct in self.dicts)) def items(self): dct = {} for d in self.dicts: for key, values in d.items(): try: dct_values = dct[key] dct_values += values except KeyError: dct[key] = list(values) return dct.items() def values(self): lst = [] for dct in self.dicts: lst += dct.values() return lst class CachedFastParser(type): """ This is a metaclass for caching `FastParser`. """ def __call__(self, grammar, source, module_path=None): if not settings.fast_parser: return Parser(grammar, source, module_path) pi = cache.parser_cache.get(module_path, None) if pi is None or isinstance(pi.parser, Parser): p = super(CachedFastParser, self).__call__(grammar, source, module_path) else: p = pi.parser # pi is a `cache.ParserCacheItem` p.update(source) return p class ParserNode(object): def __init__(self, fast_module): self._fast_module = fast_module self.parent = None self._node_children = [] self.source = None self.hash = None self.parser = None self._content_scope = self._fast_module def __repr__(self): module = self.parser.module try: return '<%s: %s-%s>' % (type(self).__name__, module.start_pos, module.end_pos) except IndexError: # There's no module yet. return '<%s: empty>' % type(self).__name__ def set_parser(self, parser, source): self.source = source self.hash = hash(source) self.parser = parser try: # With fast_parser we have either 1 subscope or only statements. self._content_scope = parser.module.subscopes[0] except IndexError: self._content_scope = parser.module # We need to be able to reset the original children of a parser. self._old_children = list(self._content_scope.children) """ scope = self._content_scope self._contents = {} for c in pr.SCOPE_CONTENTS: self._contents[c] = list(getattr(scope, c)) self._is_generator = scope.is_generator """ self._node_children = [] def reset_node(self): """ Removes changes that were applied in this class. """ self._node_children = [] scope = self._content_scope scope.children = list(self._old_children) try: # This works if it's a MergedNamesDict. # We are correcting it, because the MergedNamesDicts are artificial # and can change after closing a node. scope.names_dict = scope.names_dict.dicts[0] except AttributeError: pass def reset_contents(self): raise NotImplementedError """ scope = self._content_scope for key, c in self._contents.items(): setattr(scope, key, list(c)) scope.is_generator = self._is_generator """ """ if self.parent is None: # Global vars of the first one can be deleted, in the global scope # they make no sense. self.parser.module.global_vars = [] """ # TODO REMOVE def close(self): """ Closes the current parser node. This means that after this no further nodes should be added anymore. """ #print('CLOSE NODE', id(self), self.parent, self._node_children) # We only need to replace the dict if multiple dictionaries are used: if self._node_children: dcts = [n.parser.module.names_dict for n in self._node_children] # Need to insert the own node as well. dcts.insert(0, self._content_scope.names_dict) self._content_scope.names_dict = MergedNamesDict(dcts) def parent_until_indent(self, indent=None): if indent is None or self._indent >= indent and self.parent: if self.parent is not None: self.close() return self.parent.parent_until_indent(indent) return self @property def _indent(self): if not self.parent: return 0 module = self.parser.module try: el = module.subscopes[0] except IndexError: try: el = module.statements[0] except IndexError: try: el = module.imports[0] except IndexError: try: el = [r for r in module.returns if r is not None][0] except IndexError: el = module.children[0] return el.start_pos[1] def _set_items(self, parser, set_parent=False): # TODO global_vars ? is_generator ? """ cur = self while cur.parent is not None: cur = cur.parent cur.parser.module.global_vars += parser.module.global_vars scope.is_generator |= parser.module.is_generator """ def add_node(self, node, line_offset): """Adding a node means adding a node that was already added earlier""" # Changing the line offsets is very important, because if they don't # fit, all the start_pos values will be wrong. m = node.parser.module node.parser.position_modifier.line = line_offset self._fast_module.modules.append(m) node.parent = self self._node_children.append(node) # Insert parser objects into current structure. We only need to set the # parents and children in a good way. scope = self._content_scope for child in m.children: child.parent = scope scope.children.append(child) #print('\t\t', scope, child) """ if isinstance(i, (pr.Function, pr.Class)): for d in i.decorators: d.parent = scope """ """ scope = self.content_scope while scope is not None: #print('x',scope) if not isinstance(scope, pr.SubModule): # TODO This seems like a strange thing. Check again. scope.end_pos = node.content_scope.end_pos scope = scope.parent """ return node def add_parser(self, parser, code): # TODO REMOVE raise NotImplementedError return self.add_node(ParserNode(self._fast_module, parser, code, self), True) def all_sub_nodes(self): """ Returns all nodes including nested ones. """ for n in self._node_children: yield n for y in n.all_sub_nodes(): yield y @cache.underscore_memoization # Should only happen once! def remove_last_newline(self): self.parser.remove_last_newline() class FastParser(use_metaclass(CachedFastParser)): _keyword_re = re.compile('^[ \t]*(def|class|@|%s)' % '|'.join(FLOWS)) def __init__(self, grammar, source, module_path=None): # set values like `pr.Module`. self._grammar = grammar self.module_path = module_path self._reset_caches() self.update(source) def _reset_caches(self): self.module = FastModule(self.module_path) self.current_node = ParserNode(self.module) self.current_node.set_parser(self, '') def update(self, source): # For testing purposes: It is important that the number of parsers used # can be minimized. With this variable we can test it. self.number_parsers_used = 0 self.number_of_splits = 0 self.module.reset_caches() try: self._parse(source) except: # FastParser is cached, be careful with exceptions. self._reset_caches() raise def _split_parts(self, source): """ Split the source code into different parts. This makes it possible to parse each part seperately and therefore cache parts of the file and not everything. """ def gen_part(): text = '\n'.join(current_lines) del current_lines[:] self.number_of_splits += 1 return text def just_newlines(current_lines): for line in current_lines: line = line.lstrip('\t ') if line and line[0] not in ('#', '\r'): return False return True # Split only new lines. Distinction between \r\n is the tokenizer's # job. self._lines = source.split('\n') current_lines = [] is_decorator = False current_indent = 0 old_indent = 0 new_indent = False in_flow = False # All things within flows are simply being ignored. for l in self._lines: # check for dedents s = l.lstrip('\t ') indent = len(l) - len(s) if not s or s[0] in ('#', '\r'): current_lines.append(l) # just ignore comments and blank lines continue if indent < current_indent: # -> dedent current_indent = indent new_indent = False if not in_flow or indent < old_indent: if current_lines: yield gen_part() in_flow = False elif new_indent: current_indent = indent new_indent = False # Check lines for functions/classes and split the code there. if not in_flow: m = self._keyword_re.match(l) if m: in_flow = m.group(1) in FLOWS if not is_decorator and not in_flow: if not just_newlines(current_lines): yield gen_part() is_decorator = '@' == m.group(1) if not is_decorator: old_indent = current_indent current_indent += 1 # it must be higher new_indent = True elif is_decorator: is_decorator = False current_lines.append(l) if current_lines: yield gen_part() def _parse(self, source): """ :type source: str """ def empty_parser_node(): return self._get_node(unicode(''), unicode(''), 0, [], False) added_newline = False if source[-1] != '\n': # To be compatible with Pythons grammar, we need a newline at the # end. The parser would handle it, but since the fast parser abuses # the normal parser in various ways, we need to care for this # ourselves. source += '\n' added_newline = True line_offset = 0 start = 0 is_first = True nodes = list(self.current_node.all_sub_nodes()) # Now we can reset the node, because we have all the old nodes. self.current_node.reset_node() for code_part in self._split_parts(source): if not is_first: #print('OFF', line_offset + 1, self.current_node.parser.module.end_pos) #import pdb; pdb.set_trace() pass if is_first or line_offset + 1 == self.current_node.parser.module.end_pos[0]: indent = len(code_part) - len(code_part.lstrip('\t ')) self.current_node = self.current_node.parent_until_indent(indent) # print '#'*45,line_offset, p.module.end_pos, '\n', code_part # check if code_part has already been parsed self.current_node = self._get_node(code_part, source[start:], line_offset, nodes, not is_first) if False and is_first and self.current_node.parser.module.subscopes: raise NotImplementedError # Special case, we cannot use a function subscope as a # base scope, subscopes would save all the other contents new = empty_parser_node() # TODO should be node = self.current_node.set_parser(new, '') self.parsers.append(new) is_first = False """ if is_first: if self.current_node is None: self.current_node = ParserNode(self.module, p, code_part_actually_used) else: pass else: if node is None: self.current_node = \ self.current_node.add_parser(p, code_part_actually_used) else: self.current_node = self.current_node.add_node(node) self.parsers.append(p) """ is_first = False #else: #print '#'*45, line_offset, p.module.end_pos, 'theheck\n', repr(code_part) line_offset += code_part.count('\n') + 1 start += len(code_part) + 1 # +1 for newline if added_newline: self.current_node.remove_last_newline() # Now that the for loop is finished, we still want to close all nodes. self.current_node = self.current_node.parent_until_indent() self.current_node.close() """ if self.parsers: self.current_node = self.current_node.parent_until_indent() self.current_node.close() else: raise NotImplementedError self.parsers.append(empty_parser_node()) """ """ TODO used? self.module.end_pos = self.parsers[-1].module.end_pos """ debug.dbg('Parsed %s, with %s parsers in %s splits.' % (self.module_path, self.number_parsers_used, self.number_of_splits)) # print(self.parsers[0].module.get_code()) def _get_node(self, source, parser_code, line_offset, nodes, no_docstr): """ Side effect: Alters the list of nodes. """ h = hash(source) for index, node in enumerate(nodes): #print('EQ', node, repr(node.source), repr(source)) if node.hash == h and node.source == source: node.reset_node() nodes.remove(node) break else: tokenizer = FastTokenizer(parser_code, 0) self.number_parsers_used += 1 p = Parser(self._grammar, parser_code, self.module_path, tokenizer=tokenizer) #p.module.parent = self.module # With the new parser this is not # necessary anymore? node = ParserNode(self.module) end = line_offset + p.module.end_pos[0] if not (len(self._lines) == end): # We don't keep the last line, except if were done. A newline # ends on the next line, which is part of the next parser. But # the last parser includes the last new line. end -= 1 used_lines = self._lines[line_offset:end] code_part_actually_used = '\n'.join(used_lines) node.set_parser(p, code_part_actually_used) self.current_node.add_node(node, line_offset) return node class FastTokenizer(object): """ Breaks when certain conditions are met, i.e. a new function or class opens. """ def __init__(self, source, line_offset=0): # TODO remove the whole line_offset stuff, it's not used anymore. self.source = source self._gen = source_tokens(source, line_offset) self._closed = False # fast parser options self.current = self.previous = NEWLINE, '', (0, 0) self._in_flow = False self._is_decorator = False self._first_stmt = True self._parentheses_level = 0 self._indent_counter = 0 self._flow_indent_counter = 0 self._returned_endmarker = False def __iter__(self): return self def next(self): """ Python 2 Compatibility """ return self.__next__() def __next__(self): if self._closed: return self._finish_dedents() typ, value, start_pos, prefix = current = next(self._gen) if typ == ENDMARKER: self._closed = True self._returned_endmarker = True return current self.previous = self.current self.current = current if typ == INDENT: self._indent_counter += 1 elif typ == DEDENT: self._indent_counter -= 1 if self._in_flow and self._indent_counter == self._flow_indent_counter: self._in_flow = False elif not self._in_flow: self._closed = True return current # Parentheses ignore the indentation rules. The other three stand for # new lines. if self.previous[0] in (NEWLINE, INDENT, DEDENT) \ and not self._parentheses_level: # Check for NEWLINE, which symbolizes the indent. #print('X', repr(value), tokenize.tok_name[typ]) if not self._in_flow: self._in_flow = value in FLOWS if self._in_flow: self._flow_indent_counter = self._indent_counter elif value in ('def', 'class', '@'): # The values here are exactly the same check as in # _split_parts, but this time with tokenize and therefore # precise. if not self._is_decorator: return self._close() self._is_decorator = '@' == value if value in '([{' and value: self._parentheses_level += 1 elif value in ')]}' and value: # Ignore closing parentheses, because they are all # irrelevant for the indentation. self._parentheses_level = max(self._parentheses_level - 1, 0) return current def _close(self): if self._first_stmt: # Continue like nothing has happened, because we want to enter # the first class/function. if self.current[1] != '@': self._first_stmt = False return self.current else: self._closed = True return self._finish_dedents() def _finish_dedents(self): if self._indent_counter: self._indent_counter -= 1 return tokenize.DEDENT, '', self.current[2], '' elif not self._returned_endmarker: self._returned_endmarker = True # We're using the current prefix for the endmarker to not loose any # information. However we care about "lost" lines. The prefix of # the current line (indent) will always be included in the current # line. t, _, start_pos, prefix = next(self._gen) # \Z for the end of the string. $ is bugged, because it has the # same behavior with or without re.MULTILINE. prefix = re.sub(r'[^\n]+\Z', '', prefix) return ENDMARKER, '', start_pos, prefix else: raise StopIteration