""" Used only for REPL Completion. """ import inspect import os from jedi import common from jedi.parser.fast import FastParser from jedi.evaluate import compiled from jedi.cache import underscore_memoization from jedi.evaluate import imports class MixedObject(object): """ A ``MixedObject`` is used in two ways: 1. It uses the default logic of ``parser.tree`` objects, 2. except for getattr calls. The names dicts are generated in a fashion like ``CompiledObject``. This combined logic makes it possible to provide more powerful REPL completion. It allows side effects that are not noticable with the default parser structure to still be completeable. The biggest difference from CompiledObject to MixedObject is that we are generally dealing with Python code and not with C code. This will generate fewer special cases, because we in Python you don't have the same freedoms to modify the runtime. """ def __init__(self, evaluator, parent_context, compiled_object, tree_name): self.evaluator = evaluator self.compiled_object = compiled_object self.obj = compiled_object.obj self._tree_name = tree_name name_module = tree_name.get_root_node() if parent_context.get_node().get_root_node() != name_module: from jedi.evaluate.representation import ModuleContext module_context = ModuleContext(evaluator, name_module) name = compiled_object.get_root_context().py__name__() imports.add_module(evaluator, name, module_context) else: module_context = parent_context.get_root_context() self._context = module_context.create_context( tree_name.parent, node_is_context=True ) def get_filters(self, *args, **kwargs): yield MixedObjectFilter(self.evaluator, self) def __repr__(self): return '<%s: %s>' % (type(self).__name__, repr(self.obj)) def __getattr__(self, name): return getattr(self._context, name) class MixedName(compiled.CompiledName): """ The ``CompiledName._compiled_object`` is our MixedObject. """ @property def start_pos(self): contexts = list(self.infer()) if not contexts: # This means a start_pos that doesn't exist (compiled objects). return (0, 0) return contexts[0].name.start_pos @start_pos.setter def start_pos(self, value): # Ignore the __init__'s start_pos setter call. pass @underscore_memoization def infer(self): obj = self.parent_context.obj try: obj = getattr(obj, self.string_name) except AttributeError: # Happens e.g. in properties of # PyQt4.QtGui.QStyleOptionComboBox.currentText # -> just set it to None obj = None return [create(self._evaluator, obj, parent_context=self.parent_context)] @property def api_type(self): return next(iter(self.infer())).api_type class MixedObjectFilter(compiled.CompiledObjectFilter): name_class = MixedName def __init__(self, evaluator, mixed_object, is_instance=False): super(MixedObjectFilter, self).__init__( evaluator, mixed_object, is_instance) self._mixed_object = mixed_object #def _create(self, name): #return MixedName(self._evaluator, self._compiled_object, name) def parse(grammar, path): with open(path) as f: source = f.read() source = common.source_to_unicode(source) return FastParser(grammar, source, path) def _load_module(evaluator, path, python_object): module = parse(evaluator.grammar, path).module python_module = inspect.getmodule(python_object) evaluator.modules[python_module.__name__] = module return module def find_syntax_node_name(evaluator, python_object): try: path = inspect.getsourcefile(python_object) except TypeError: # The type might not be known (e.g. class_with_dict.__weakref__) return None if path is None or not os.path.exists(path): # The path might not exist or be e.g. . return None module = _load_module(evaluator, path, python_object) if inspect.ismodule(python_object): # We don't need to check names for modules, because there's not really # a way to write a module in a module in Python (and also __name__ can # be something like ``email.utils``). return module.name name_str = python_object.__name__ if name_str == '': return None # It's too hard to find lambdas. # Doesn't always work (e.g. os.stat_result) try: names = module.used_names[name_str] except KeyError: return None names = [n for n in names if n.is_definition()] try: code = python_object.__code__ # By using the line number of a code object we make the lookup in a # file pretty easy. There's still a possibility of people defining # stuff like ``a = 3; foo(a); a = 4`` on the same line, but if people # do so we just don't care. line_nr = code.co_firstlineno except AttributeError: pass else: line_names = [name for name in names if name.start_pos[0] == line_nr] # There's a chance that the object is not available anymore, because # the code has changed in the background. if line_names: return line_names[-1] # It's really hard to actually get the right definition, here as a last # resort we just return the last one. This chance might lead to odd # completions at some points but will lead to mostly correct type # inference, because people tend to define a public name in a module only # once. return names[-1] @compiled.compiled_objects_cache('mixed_cache') def create(evaluator, obj, parent_context=None, *args): tree_name = find_syntax_node_name(evaluator, obj) compiled_object = compiled.create( evaluator, obj, parent_context=parent_context.compiled_object) if tree_name is None: return compiled_object return MixedObject(evaluator, parent_context, compiled_object, tree_name)