pyflyby 1.9.0__tar.gz → 1.9.1__tar.gz

{pyflyby-1.9.0/lib/python/pyflyby.egg-info → pyflyby-1.9.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pyflyby
-Version: 1.9.0
+Version: 1.9.1
 Summary: pyflyby - Python development productivity tools, in particular automatic import management
 Home-page: https://pypi.org/project/pyflyby/
 Author: Karl Chen

{pyflyby-1.9.0 → pyflyby-1.9.1}/bin/pyflyby/_autoimp.py

@@ -22,7 +22,7 @@ from   pyflyby._importdb        import ImportDB
 from   pyflyby._importstmt      import Import
 from   pyflyby._log             import logger
 from   pyflyby._modules         import ModuleHandle
-from   pyflyby._parse           import PythonBlock, infer_compile_mode
+from   pyflyby._parse           import PythonBlock, infer_compile_mode, _is_ast_str
 
 if sys.version_info >= (3, 12):
     ATTRIBUTE_NAME = "value"
@@ -34,6 +34,11 @@ if sys.version_info > (3, 11):
 else:
     LOAD_SHIFT = 0
 
+if sys.version_info > (3, 11):
+    LOAD_SHIFT = 1
+else:
+    LOAD_SHIFT = 0
+
 NoneType = type(None)
 EllipsisType = type(Ellipsis)
 
@@ -580,7 +585,7 @@ class _MissingImportFinder(object):
             if not isinstance(node.value, ast.List):
                 logger.warning("Don't know how to handle __all__ as (%s)" % node.value)
                 return
-            if not all(isinstance(e, ast.Str) for e in node.value.elts):
+            if not all(_is_ast_str(e) for e in node.value.elts):
                 logger.warning("Don't know how to handle __all__ with list elements other than str")
                 return
             for e in node.value.elts:
@@ -588,7 +593,11 @@ class _MissingImportFinder(object):
 
     def visit_ClassDef(self, node):
         logger.debug("visit_ClassDef(%r)", node)
-        assert node._fields == ('name', 'bases', 'keywords', 'body', 'decorator_list')
+        if sys.version_info > (3,12):
+            # we don't visit type_params, so autoimport won't work yet for type annotations
+            assert node._fields == ('name', 'bases', 'keywords', 'body', 'decorator_list', 'type_params'), node._fields
+        else:
+            assert node._fields == ('name', 'bases', 'keywords', 'body', 'decorator_list'), node._fields
         self.visit(node.bases)
         self.visit(node.decorator_list)
         # The class's name is only visible to others (not to the body to the
@@ -619,7 +628,11 @@ class _MissingImportFinder(object):
         #     scope.
         #   - Store the name in the current scope (but not visibly to
         #     args/decorator_list).
-        assert node._fields == ('name', 'args', 'body', 'decorator_list', 'returns', 'type_comment'), node._fields
+        if sys.version_info > (3, 12):
+            # we don't visit type_params, so autoimport won't work yet for type annotations
+            assert node._fields ==  ('name', 'args', 'body', 'decorator_list', 'returns', 'type_comment', 'type_params'), node._fields
+        else:
+            assert node._fields ==  ('name', 'args', 'body', 'decorator_list', 'returns', 'type_comment'), node._fields
         with self._NewScopeCtx(include_class_scopes=True):
             self.visit(node.decorator_list)
             self.visit(node.args)

{pyflyby-1.9.0/lib/python → pyflyby-1.9.1/bin}/pyflyby/_importclns.py

@@ -215,8 +215,8 @@ class ImportSet(object):
         """
         :return:
           (mapping from name to __future__ imports,
-           mapping from name to non-'from' imports,
-           mapping from name to 'from' imports)
+          mapping from name to non-'from' imports,
+          mapping from name to 'from' imports)
         """
         ftr_imports = defaultdict(set)
         pkg_imports = defaultdict(set)

{pyflyby-1.9.0 → pyflyby-1.9.1}/bin/pyflyby/_importstmt.py

@@ -15,17 +15,16 @@ from   pyflyby._parse           import PythonStatement
 from   pyflyby._util            import (Inf, cached_attribute, cmp,
                                         longest_common_prefix)
 
-from   black                    import format_str, FileMode as Mode
-from   black.files              import find_pyproject_toml, parse_pyproject_toml
-from   black.mode               import TargetVersion
 
+from   typing                   import Dict, Tuple, Optional
 
-def read_black_config():
-    """Read the black configuration from ``pyproject.toml``
 
 
-    """
-    pyproject_path = find_pyproject_toml('.')
+def read_black_config() -> Dict:
+    """Read the black configuration from ``pyproject.toml``"""
+    from black.files import find_pyproject_toml, parse_pyproject_toml
+
+    pyproject_path = find_pyproject_toml((".",))
 
     raw_config = parse_pyproject_toml(pyproject_path) if pyproject_path else {}
 
@@ -348,24 +347,31 @@ class Import(object):
             return NotImplemented
         return self._data < other._data
 
-def _validate_alias(arg):
+def _validate_alias(arg) -> Tuple[str, Optional[str]]:
     """
     Ensure each alias is a tuple (str, None|str), and return it.
 
     """
     assert isinstance(arg, tuple)
-    a0,a1 = arg
+    # Pyright does not seem to be able to infer the length from a
+    # the unpacking.
+    assert len(arg) == 2
+    a0, a1 = arg
     assert isinstance(a0, str)
     assert isinstance(a1, (str, type(None)))
     return arg
 
 @total_ordering
-class ImportStatement(object):
+class ImportStatement:
     """
     Token-level representation of an import statement containing multiple
     imports from a single module.  Corresponds to an ``ast.ImportFrom`` or
     ``ast.Import``.
     """
+
+    aliases : Tuple[Tuple[str, Optional[str]],...]
+    fromname : Optional[str]
+
     def __new__(cls, arg):
         if isinstance(arg, cls):
             return arg
@@ -381,10 +387,10 @@ class ImportStatement(object):
         raise TypeError
 
     @classmethod
-    def from_parts(cls, fromname, aliases):
-        assert isinstance(aliases, list)
+    def from_parts(cls, fromname:Optional[str], aliases:Tuple[Tuple[str, Optional[str]],...]):
+        assert isinstance(aliases, tuple)
         assert len(aliases) > 0
-        
+
         self = object.__new__(cls)
         self.fromname = fromname
         self.aliases = tuple(_validate_alias(a) for a in aliases)
@@ -440,7 +446,7 @@ class ImportStatement(object):
             raise NonImportStatementError(
                     'Expected ImportStatement, got {node}'.format(node=node)
                     )
-        aliases = [ (alias.name, alias.asname) for alias in node.names ]
+        aliases = tuple( (alias.name, alias.asname) for alias in node.names )
         return cls.from_parts(fromname, aliases)
 
     @classmethod
@@ -463,7 +469,7 @@ class ImportStatement(object):
             raise ValueError(
                 "Inconsistent module names %r" % (sorted(module_names),))
         fromname = list(module_names)[0]
-        aliases = [ imp.split[1:] for imp in imports ]
+        aliases = tuple(imp.split[1:] for imp in imports)
         return cls.from_parts(fromname, aliases)
 
     @cached_attribute
@@ -529,12 +535,15 @@ class ImportStatement(object):
         return res
 
     @staticmethod
-    def run_black(src_contents: str, params) -> str:
+    def run_black(src_contents: str, params:FormatParams) -> str:
         """Run the black formatter for the Python source code given as a string
 
         This is adapted from https://github.com/akaihola/darker
 
         """
+        from black import format_str, FileMode
+        from black.mode import TargetVersion
+
         black_config = read_black_config()
         mode = dict()
         if "line_length" in black_config:
@@ -568,14 +577,12 @@ class ImportStatement(object):
             # ``--skip-string-normalization``, but the parameter for
             # ``black.Mode`` needs to be the opposite boolean of
             # ``skip-string-normalization``, hence the inverse boolean
-            mode["string_normalization"] = not black_config[
-                "skip_string_normalization"
-            ]
+            mode["string_normalization"] = not black_config["skip_string_normalization"]
 
         # The custom handling of empty and all-whitespace files below will be unnecessary if
         # https://github.com/psf/black/pull/2484 lands in Black.
         contents_for_black = src_contents
-        return format_str(contents_for_black, mode=Mode(**mode))
+        return format_str(contents_for_black, mode=FileMode(**mode))
 
     @property
     def _data(self):

{pyflyby-1.9.0/lib/python → pyflyby-1.9.1/bin}/pyflyby/_modules.py

@@ -125,6 +125,8 @@ class ModuleHandle(object):
     A handle to a module.
     """
 
+    name: DottedIdentifier
+
     def __new__(cls, arg):
         if isinstance(arg, cls):
             return arg
@@ -206,14 +208,8 @@ class ModuleHandle(object):
         if self.parent and not self.parent.exists:
             return False
 
-        # pkgutil.find_loader returns None for unimported Python 3
-        # namespace packages, so prefer importlib
-        try:
-            import importlib.util
-            find = importlib.util.find_spec
-        except ImportError:
-            import pkgutil
-            find = pkgutil.find_loader
+        import importlib.util
+        find = importlib.util.find_spec
 
         try:
             pkg = find(name)
@@ -241,6 +237,7 @@ class ModuleHandle(object):
         # module, which may be undesirable.
         import pkgutil
         try:
+             #TODO: deprecated and will be removed in 3.14
             loader = pkgutil.get_loader(str(self.name))
         except ImportError:
             return None
@@ -303,7 +300,7 @@ class ModuleHandle(object):
         Enumerate the importable submodules of this module.
 
           >>> ModuleHandle("email").submodules      # doctest:+ELLIPSIS
-          (..., 'email.encoders', ..., 'email.mime', ...)
+          (..., ModuleHandle('email.encoders'), ..., ModuleHandle('email.mime'), ...)
 
         :rtype:
           ``tuple`` of `ModuleHandle` s
@@ -366,6 +363,7 @@ class ModuleHandle(object):
 
         # If __all__ is defined, try to use it
         all_is_good = False  # pun intended
+        all_members = []
         if "__all__" in members:
             # Iterate through the nodes and reconstruct the
             # value of __all__
@@ -418,7 +416,7 @@ class ModuleHandle(object):
         members = [n for n in members if not n.startswith("_")]
 
         # Filter out artificially added "deep" members.
-        members = [(n, None) for n in members if "." not in n]
+        members = tuple([(n, None) for n in members if "." not in n])
         if not members:
             return None
         return ImportSet(
@@ -482,7 +480,11 @@ class ModuleHandle(object):
             result = module.module
         except Exception as e:
             raise ImportError(e)
-        for part, prefix in zip(identifier, prefixes(identifier))[1:]:
+        # TODO: as far as I can tell the code here is never reached, or haven't
+        # been in quite some time as the line below was invalid on Python 3 since 2011
+        # zip(...)[...] fails as zip is not indexable.
+        # the only place that seem to be using this method is XrefScanner.
+        for part, prefix in list(zip(identifier, prefixes(identifier)))[1:]:
             try:
                 result = getattr(result, str(part))
             except Exception:

{pyflyby-1.9.0/lib/python → pyflyby-1.9.1/bin}/pyflyby/_parse.py

@@ -260,7 +260,10 @@ def _test_parse_string_literal(text, flags):
     body = module_node.body
     if not _is_ast_str_or_byte(body):
         return None
-    return body.s
+    if sys.version_info < (3 ,9):
+        return body.s
+    else:
+        return body.value
 
 
 AstNodeContext = namedtuple("AstNodeContext", "parent field index")

{pyflyby-1.9.0/lib/python → pyflyby-1.9.1/bin}/pyflyby/_py.py

@@ -275,6 +275,7 @@ Examples
 
 
 from   functools                import total_ordering
+from   typing                   import Any
 
 from   pyflyby._util            import cmp
 
@@ -377,7 +378,7 @@ FLAGS = CompilerFlags(["absolute_import", "with_statement", "division",
                        "print_function"])
 
 
-def _get_argspec(arg, _recurse=False):
+def _get_argspec(arg:Any) -> inspect.FullArgSpec:
     from inspect import getfullargspec as getargspec, FullArgSpec as ArgSpec
     if isinstance(arg, FunctionType):
         return getargspec(arg)
@@ -394,8 +395,6 @@ def _get_argspec(arg, _recurse=False):
         else:
             argspec = _get_argspec(arg.__init__)
             return ArgSpec(argspec.args[1:], *argspec[1:])
-    elif _recurse and hasattr(arg, '__call__'):
-        return _get_argspec(arg.__call__, _recurse=False)
     elif callable(arg):
         # Unknown, probably a built-in method.
         return ArgSpec([], "args", "kwargs", None, [], None, {})
@@ -458,8 +457,16 @@ def _requires_parens_as_function(function_name:str):
     return True
 
 
-def _format_call_spec(function_name, argspec):
-    callspec = inspect.formatargspec(*argspec)
+def _format_call_spec(function_name:str, obj:Any)-> str:
+    # using signature() is not strictly identical
+    # as it might look at __text_signature__ and/or respect possitional only
+    # forward slash:
+    #   >>> def foo(a, /, b)
+    # whcih formatargspec did not do.
+    # argspec = _get_argspec(obj)
+    # old_callspect = inspect.formatargspec(*argspec)
+    # assert old_callspect == callspec , f"{old_callspect} !={callspec}"
+    callspec = str(inspect.signature(obj))
     if _requires_parens_as_function(function_name):
         return "(%s)%s" % (function_name, callspec)
     else:
@@ -483,11 +490,13 @@ except ImportError:
         return "'" + s.replace("'", "'\"'\"'") + "'"
 
 
-def _build_function_usage_string(function_name, argspec, prefix):
+def _build_function_usage_string(function_name:str, obj:Any, prefix:str):
+    argspec = _get_argspec(obj)
+
     usage = []
     # TODO: colorize
     usage.append("Python signature:")
-    usage.append("  >"+">> " + _format_call_spec(function_name, argspec))
+    usage.append("  >"+">> " + _format_call_spec(function_name, obj))
     usage.append("")
     usage.append("Command-line signature:")
     keywords = argspec.varkw
@@ -902,11 +911,10 @@ def _get_help(expr, verbosity=1):
     # TODO: colorize headers
     result = ""
     obj = expr.value
-    name = str(expr.source)
+    name:str = str(expr.source)
     if callable(obj):
-        argspec = _get_argspec(obj)
         prefix = os.path.basename(sys.orig_argv[0]) + " "
-        result += _build_function_usage_string(name, argspec, prefix)
+        result += _build_function_usage_string(name, obj, prefix)
     if verbosity == 0:
         include_filename = False
         include_doc      = False

{pyflyby-1.9.0 → pyflyby-1.9.1}/bin/pyflyby/_util.py

@@ -7,60 +7,38 @@
 from   contextlib               import contextmanager
 import inspect
 import os
-from   six                      import reraise
 import sys
 import types
 
+# There used to be a custom caching_attribute implementation
+# this now uses functools's cached_property which is understood by
+# various static analysis tools.
+from functools import cached_property as cached_attribute # noqa: F401
+
 # Python 2/3 compatibility
 DictProxyType = type(object.__dict__)
 
-
-def memoize(function):
-    cache = {}
-    def wrapped_fn(*args, **kwargs):
-        cache_key = (args, tuple(sorted(kwargs.items())))
-        try:
-            return cache[cache_key]
-        except KeyError:
-            result = function(*args, **kwargs)
-            cache[cache_key] = result
-            return result
-    wrapped_fn.cache = cache
-    return wrapped_fn
+if sys.version_info > (3,9):
+    from functools import cache as memoize
+else:
+    def memoize(function):
+        cache = {}
+        def wrapped_fn(*args, **kwargs):
+            cache_key = (args, tuple(sorted(kwargs.items())))
+            try:
+                return cache[cache_key]
+            except KeyError:
+                result = function(*args, **kwargs)
+                cache[cache_key] = result
+                return result
+        wrapped_fn.cache = cache
+        return wrapped_fn
 
 
 class WrappedAttributeError(Exception):
     pass
 
 
-class cached_attribute(object):
-    """Computes attribute value and caches it in instance.
-
-    Example::
-
-        class MyClass(object):
-            @cached_attribute
-            def myMethod(self):
-                # ...
-
-    Use "del inst.myMethod" to clear cache."""
-    # http://code.activestate.com/recipes/276643/
-
-    def __init__(self, method, name=None):
-        self.method = method
-        self.name = name or method.__name__
-
-    def __get__(self, inst, cls):
-        if inst is None:
-            return self
-        try:
-            result = self.method(inst)
-        except AttributeError as e:
-            reraise(WrappedAttributeError, WrappedAttributeError(str(e)), sys.exc_info()[2])
-        setattr(inst, self.name, result)
-        return result
-
-
 def stable_unique(items):
     """
     Return a copy of ``items`` without duplicates.  The order of other items is

{pyflyby-1.9.0/lib/python → pyflyby-1.9.1/bin}/pyflyby/_version.py

@@ -5,4 +5,4 @@
 
 
 
-__version__ = '1.9.0'
+__version__ = '1.9.1'

{pyflyby-1.9.0 → pyflyby-1.9.1}/lib/python/pyflyby/_autoimp.py

@@ -22,7 +22,7 @@ from   pyflyby._importdb        import ImportDB
 from   pyflyby._importstmt      import Import
 from   pyflyby._log             import logger
 from   pyflyby._modules         import ModuleHandle
-from   pyflyby._parse           import PythonBlock, infer_compile_mode
+from   pyflyby._parse           import PythonBlock, infer_compile_mode, _is_ast_str
 
 if sys.version_info >= (3, 12):
     ATTRIBUTE_NAME = "value"
@@ -34,6 +34,11 @@ if sys.version_info > (3, 11):
 else:
     LOAD_SHIFT = 0
 
+if sys.version_info > (3, 11):
+    LOAD_SHIFT = 1
+else:
+    LOAD_SHIFT = 0
+
 NoneType = type(None)
 EllipsisType = type(Ellipsis)
 
@@ -580,7 +585,7 @@ class _MissingImportFinder(object):
             if not isinstance(node.value, ast.List):
                 logger.warning("Don't know how to handle __all__ as (%s)" % node.value)
                 return
-            if not all(isinstance(e, ast.Str) for e in node.value.elts):
+            if not all(_is_ast_str(e) for e in node.value.elts):
                 logger.warning("Don't know how to handle __all__ with list elements other than str")
                 return
             for e in node.value.elts:
@@ -588,7 +593,11 @@ class _MissingImportFinder(object):
 
     def visit_ClassDef(self, node):
         logger.debug("visit_ClassDef(%r)", node)
-        assert node._fields == ('name', 'bases', 'keywords', 'body', 'decorator_list')
+        if sys.version_info > (3,12):
+            # we don't visit type_params, so autoimport won't work yet for type annotations
+            assert node._fields == ('name', 'bases', 'keywords', 'body', 'decorator_list', 'type_params'), node._fields
+        else:
+            assert node._fields == ('name', 'bases', 'keywords', 'body', 'decorator_list'), node._fields
         self.visit(node.bases)
         self.visit(node.decorator_list)
         # The class's name is only visible to others (not to the body to the
@@ -619,7 +628,11 @@ class _MissingImportFinder(object):
         #     scope.
         #   - Store the name in the current scope (but not visibly to
         #     args/decorator_list).
-        assert node._fields == ('name', 'args', 'body', 'decorator_list', 'returns', 'type_comment'), node._fields
+        if sys.version_info > (3, 12):
+            # we don't visit type_params, so autoimport won't work yet for type annotations
+            assert node._fields ==  ('name', 'args', 'body', 'decorator_list', 'returns', 'type_comment', 'type_params'), node._fields
+        else:
+            assert node._fields ==  ('name', 'args', 'body', 'decorator_list', 'returns', 'type_comment'), node._fields
         with self._NewScopeCtx(include_class_scopes=True):
             self.visit(node.decorator_list)
             self.visit(node.args)

{pyflyby-1.9.0/bin → pyflyby-1.9.1/lib/python}/pyflyby/_importclns.py

@@ -215,8 +215,8 @@ class ImportSet(object):
         """
         :return:
           (mapping from name to __future__ imports,
-           mapping from name to non-'from' imports,
-           mapping from name to 'from' imports)
+          mapping from name to non-'from' imports,
+          mapping from name to 'from' imports)
         """
         ftr_imports = defaultdict(set)
         pkg_imports = defaultdict(set)

{pyflyby-1.9.0 → pyflyby-1.9.1}/lib/python/pyflyby/_importstmt.py

@@ -15,17 +15,16 @@ from   pyflyby._parse           import PythonStatement
 from   pyflyby._util            import (Inf, cached_attribute, cmp,
                                         longest_common_prefix)
 
-from   black                    import format_str, FileMode as Mode
-from   black.files              import find_pyproject_toml, parse_pyproject_toml
-from   black.mode               import TargetVersion
 
+from   typing                   import Dict, Tuple, Optional
 
-def read_black_config():
-    """Read the black configuration from ``pyproject.toml``
 
 
-    """
-    pyproject_path = find_pyproject_toml('.')
+def read_black_config() -> Dict:
+    """Read the black configuration from ``pyproject.toml``"""
+    from black.files import find_pyproject_toml, parse_pyproject_toml
+
+    pyproject_path = find_pyproject_toml((".",))
 
     raw_config = parse_pyproject_toml(pyproject_path) if pyproject_path else {}
 
@@ -348,24 +347,31 @@ class Import(object):
             return NotImplemented
         return self._data < other._data
 
-def _validate_alias(arg):
+def _validate_alias(arg) -> Tuple[str, Optional[str]]:
     """
     Ensure each alias is a tuple (str, None|str), and return it.
 
     """
     assert isinstance(arg, tuple)
-    a0,a1 = arg
+    # Pyright does not seem to be able to infer the length from a
+    # the unpacking.
+    assert len(arg) == 2
+    a0, a1 = arg
     assert isinstance(a0, str)
     assert isinstance(a1, (str, type(None)))
     return arg
 
 @total_ordering
-class ImportStatement(object):
+class ImportStatement:
     """
     Token-level representation of an import statement containing multiple
     imports from a single module.  Corresponds to an ``ast.ImportFrom`` or
     ``ast.Import``.
     """
+
+    aliases : Tuple[Tuple[str, Optional[str]],...]
+    fromname : Optional[str]
+
     def __new__(cls, arg):
         if isinstance(arg, cls):
             return arg
@@ -381,10 +387,10 @@ class ImportStatement(object):
         raise TypeError
 
     @classmethod
-    def from_parts(cls, fromname, aliases):
-        assert isinstance(aliases, list)
+    def from_parts(cls, fromname:Optional[str], aliases:Tuple[Tuple[str, Optional[str]],...]):
+        assert isinstance(aliases, tuple)
         assert len(aliases) > 0
-        
+
         self = object.__new__(cls)
         self.fromname = fromname
         self.aliases = tuple(_validate_alias(a) for a in aliases)
@@ -440,7 +446,7 @@ class ImportStatement(object):
             raise NonImportStatementError(
                     'Expected ImportStatement, got {node}'.format(node=node)
                     )
-        aliases = [ (alias.name, alias.asname) for alias in node.names ]
+        aliases = tuple( (alias.name, alias.asname) for alias in node.names )
         return cls.from_parts(fromname, aliases)
 
     @classmethod
@@ -463,7 +469,7 @@ class ImportStatement(object):
             raise ValueError(
                 "Inconsistent module names %r" % (sorted(module_names),))
         fromname = list(module_names)[0]
-        aliases = [ imp.split[1:] for imp in imports ]
+        aliases = tuple(imp.split[1:] for imp in imports)
         return cls.from_parts(fromname, aliases)
 
     @cached_attribute
@@ -529,12 +535,15 @@ class ImportStatement(object):
         return res
 
     @staticmethod
-    def run_black(src_contents: str, params) -> str:
+    def run_black(src_contents: str, params:FormatParams) -> str:
         """Run the black formatter for the Python source code given as a string
 
         This is adapted from https://github.com/akaihola/darker
 
         """
+        from black import format_str, FileMode
+        from black.mode import TargetVersion
+
         black_config = read_black_config()
         mode = dict()
         if "line_length" in black_config:
@@ -568,14 +577,12 @@ class ImportStatement(object):
             # ``--skip-string-normalization``, but the parameter for
             # ``black.Mode`` needs to be the opposite boolean of
             # ``skip-string-normalization``, hence the inverse boolean
-            mode["string_normalization"] = not black_config[
-                "skip_string_normalization"
-            ]
+            mode["string_normalization"] = not black_config["skip_string_normalization"]
 
         # The custom handling of empty and all-whitespace files below will be unnecessary if
         # https://github.com/psf/black/pull/2484 lands in Black.
         contents_for_black = src_contents
-        return format_str(contents_for_black, mode=Mode(**mode))
+        return format_str(contents_for_black, mode=FileMode(**mode))
 
     @property
     def _data(self):