jaclang 0.7.34__py3-none-any.whl → 0.8.0__py3-none-any.whl

jaclang/vendor/mypy/find_sources.py

@@ -1,243 +0,0 @@
-"""Routines for finding the sources that mypy will check"""
-
-from __future__ import annotations
-
-import functools
-import os
-from typing import Final, Sequence
-
-from mypy.fscache import FileSystemCache
-from mypy.modulefinder import PYTHON_EXTENSIONS, BuildSource, matches_exclude, mypy_path
-from mypy.options import Options
-
-PY_EXTENSIONS: Final = tuple(PYTHON_EXTENSIONS)
-
-
-class InvalidSourceList(Exception):
-    """Exception indicating a problem in the list of sources given to mypy."""
-
-
-def create_source_list(
-    paths: Sequence[str],
-    options: Options,
-    fscache: FileSystemCache | None = None,
-    allow_empty_dir: bool = False,
-) -> list[BuildSource]:
-    """From a list of source files/directories, makes a list of BuildSources.
-
-    Raises InvalidSourceList on errors.
-    """
-    fscache = fscache or FileSystemCache()
-    finder = SourceFinder(fscache, options)
-
-    sources = []
-    for path in paths:
-        path = os.path.normpath(path)
-        if path.endswith(PY_EXTENSIONS):
-            # Can raise InvalidSourceList if a directory doesn't have a valid module name.
-            name, base_dir = finder.crawl_up(path)
-            sources.append(BuildSource(path, name, None, base_dir))
-        elif fscache.isdir(path):
-            sub_sources = finder.find_sources_in_dir(path)
-            if not sub_sources and not allow_empty_dir:
-                raise InvalidSourceList(f"There are no .py[i] files in directory '{path}'")
-            sources.extend(sub_sources)
-        else:
-            mod = os.path.basename(path) if options.scripts_are_modules else None
-            sources.append(BuildSource(path, mod, None))
-    return sources
-
-
-def keyfunc(name: str) -> tuple[bool, int, str]:
-    """Determines sort order for directory listing.
-
-    The desirable properties are:
-    1) foo < foo.pyi < foo.py
-    2) __init__.py[i] < foo
-    """
-    base, suffix = os.path.splitext(name)
-    for i, ext in enumerate(PY_EXTENSIONS):
-        if suffix == ext:
-            return (base != "__init__", i, base)
-    return (base != "__init__", -1, name)
-
-
-def normalise_package_base(root: str) -> str:
-    if not root:
-        root = os.curdir
-    root = os.path.abspath(root)
-    if root.endswith(os.sep):
-        root = root[:-1]
-    return root
-
-
-def get_explicit_package_bases(options: Options) -> list[str] | None:
-    """Returns explicit package bases to use if the option is enabled, or None if disabled.
-
-    We currently use MYPYPATH and the current directory as the package bases. In the future,
-    when --namespace-packages is the default could also use the values passed with the
-    --package-root flag, see #9632.
-
-    Values returned are normalised so we can use simple string comparisons in
-    SourceFinder.is_explicit_package_base
-    """
-    if not options.explicit_package_bases:
-        return None
-    roots = mypy_path() + options.mypy_path + [os.getcwd()]
-    return [normalise_package_base(root) for root in roots]
-
-
-class SourceFinder:
-    def __init__(self, fscache: FileSystemCache, options: Options) -> None:
-        self.fscache = fscache
-        self.explicit_package_bases = get_explicit_package_bases(options)
-        self.namespace_packages = options.namespace_packages
-        self.exclude = options.exclude
-        self.verbosity = options.verbosity
-
-    def is_explicit_package_base(self, path: str) -> bool:
-        assert self.explicit_package_bases
-        return normalise_package_base(path) in self.explicit_package_bases
-
-    def find_sources_in_dir(self, path: str) -> list[BuildSource]:
-        sources = []
-
-        seen: set[str] = set()
-        names = sorted(self.fscache.listdir(path), key=keyfunc)
-        for name in names:
-            # Skip certain names altogether
-            if name in ("__pycache__", "site-packages", "node_modules") or name.startswith("."):
-                continue
-            subpath = os.path.join(path, name)
-
-            if matches_exclude(subpath, self.exclude, self.fscache, self.verbosity >= 2):
-                continue
-
-            if self.fscache.isdir(subpath):
-                sub_sources = self.find_sources_in_dir(subpath)
-                if sub_sources:
-                    seen.add(name)
-                    sources.extend(sub_sources)
-            else:
-                stem, suffix = os.path.splitext(name)
-                if stem not in seen and suffix in PY_EXTENSIONS:
-                    seen.add(stem)
-                    module, base_dir = self.crawl_up(subpath)
-                    sources.append(BuildSource(subpath, module, None, base_dir))
-
-        return sources
-
-    def crawl_up(self, path: str) -> tuple[str, str]:
-        """Given a .py[i] filename, return module and base directory.
-
-        For example, given "xxx/yyy/foo/bar.py", we might return something like:
-        ("foo.bar", "xxx/yyy")
-
-        If namespace packages is off, we crawl upwards until we find a directory without
-        an __init__.py
-
-        If namespace packages is on, we crawl upwards until the nearest explicit base directory.
-        Failing that, we return one past the highest directory containing an __init__.py
-
-        We won't crawl past directories with invalid package names.
-        The base directory returned is an absolute path.
-        """
-        path = os.path.abspath(path)
-        parent, filename = os.path.split(path)
-
-        module_name = strip_py(filename) or filename
-
-        parent_module, base_dir = self.crawl_up_dir(parent)
-        if module_name == "__init__":
-            return parent_module, base_dir
-
-        # Note that module_name might not actually be a valid identifier, but that's okay
-        # Ignoring this possibility sidesteps some search path confusion
-        module = module_join(parent_module, module_name)
-        return module, base_dir
-
-    def crawl_up_dir(self, dir: str) -> tuple[str, str]:
-        return self._crawl_up_helper(dir) or ("", dir)
-
-    @functools.lru_cache  # noqa: B019
-    def _crawl_up_helper(self, dir: str) -> tuple[str, str] | None:
-        """Given a directory, maybe returns module and base directory.
-
-        We return a non-None value if we were able to find something clearly intended as a base
-        directory (as adjudicated by being an explicit base directory or by containing a package
-        with __init__.py).
-
-        This distinction is necessary for namespace packages, so that we know when to treat
-        ourselves as a subpackage.
-        """
-        # stop crawling if we're an explicit base directory
-        if self.explicit_package_bases is not None and self.is_explicit_package_base(dir):
-            return "", dir
-
-        parent, name = os.path.split(dir)
-        if name.endswith("-stubs"):
-            name = name[:-6]  # PEP-561 stub-only directory
-
-        # recurse if there's an __init__.py
-        init_file = self.get_init_file(dir)
-        if init_file is not None:
-            if not name.isidentifier():
-                # in most cases the directory name is invalid, we'll just stop crawling upwards
-                # but if there's an __init__.py in the directory, something is messed up
-                raise InvalidSourceList(f"{name} is not a valid Python package name")
-            # we're definitely a package, so we always return a non-None value
-            mod_prefix, base_dir = self.crawl_up_dir(parent)
-            return module_join(mod_prefix, name), base_dir
-
-        # stop crawling if we're out of path components or our name is an invalid identifier
-        if not name or not parent or not name.isidentifier():
-            return None
-
-        # stop crawling if namespace packages is off (since we don't have an __init__.py)
-        if not self.namespace_packages:
-            return None
-
-        # at this point: namespace packages is on, we don't have an __init__.py and we're not an
-        # explicit base directory
-        result = self._crawl_up_helper(parent)
-        if result is None:
-            # we're not an explicit base directory and we don't have an __init__.py
-            # and none of our parents are either, so return
-            return None
-        # one of our parents was an explicit base directory or had an __init__.py, so we're
-        # definitely a subpackage! chain our name to the module.
-        mod_prefix, base_dir = result
-        return module_join(mod_prefix, name), base_dir
-
-    def get_init_file(self, dir: str) -> str | None:
-        """Check whether a directory contains a file named __init__.py[i].
-
-        If so, return the file's name (with dir prefixed).  If not, return None.
-
-        This prefers .pyi over .py (because of the ordering of PY_EXTENSIONS).
-        """
-        for ext in PY_EXTENSIONS:
-            f = os.path.join(dir, "__init__" + ext)
-            if self.fscache.isfile(f):
-                return f
-            if ext == ".py" and self.fscache.init_under_package_root(f):
-                return f
-        return None
-
-
-def module_join(parent: str, child: str) -> str:
-    """Join module ids, accounting for a possibly empty parent."""
-    if parent:
-        return parent + "." + child
-    return child
-
-
-def strip_py(arg: str) -> str | None:
-    """Strip a trailing .py or .pyi suffix.
-
-    Return None if no such suffix is found.
-    """
-    for ext in PY_EXTENSIONS:
-        if arg.endswith(ext):
-            return arg[: -len(ext)]
-    return None

jaclang/vendor/mypy/fixup.py

@@ -1,428 +0,0 @@
-"""Fix up various things after deserialization."""
-
-from __future__ import annotations
-
-from typing import Any, Final
-
-from mypy.lookup import lookup_fully_qualified
-from mypy.nodes import (
-    Block,
-    ClassDef,
-    Decorator,
-    FuncDef,
-    MypyFile,
-    OverloadedFuncDef,
-    ParamSpecExpr,
-    SymbolTable,
-    TypeAlias,
-    TypeInfo,
-    TypeVarExpr,
-    TypeVarTupleExpr,
-    Var,
-)
-from mypy.types import (
-    NOT_READY,
-    AnyType,
-    CallableType,
-    Instance,
-    LiteralType,
-    Overloaded,
-    Parameters,
-    ParamSpecType,
-    TupleType,
-    TypeAliasType,
-    TypedDictType,
-    TypeOfAny,
-    TypeType,
-    TypeVarTupleType,
-    TypeVarType,
-    TypeVisitor,
-    UnboundType,
-    UnionType,
-    UnpackType,
-)
-from mypy.visitor import NodeVisitor
-
-
-# N.B: we do a allow_missing fixup when fixing up a fine-grained
-# incremental cache load (since there may be cross-refs into deleted
-# modules)
-def fixup_module(tree: MypyFile, modules: dict[str, MypyFile], allow_missing: bool) -> None:
-    node_fixer = NodeFixer(modules, allow_missing)
-    node_fixer.visit_symbol_table(tree.names, tree.fullname)
-
-
-# TODO: Fix up .info when deserializing, i.e. much earlier.
-class NodeFixer(NodeVisitor[None]):
-    current_info: TypeInfo | None = None
-
-    def __init__(self, modules: dict[str, MypyFile], allow_missing: bool) -> None:
-        self.modules = modules
-        self.allow_missing = allow_missing
-        self.type_fixer = TypeFixer(self.modules, allow_missing)
-
-    # NOTE: This method isn't (yet) part of the NodeVisitor API.
-    def visit_type_info(self, info: TypeInfo) -> None:
-        save_info = self.current_info
-        try:
-            self.current_info = info
-            if info.defn:
-                info.defn.accept(self)
-            if info.names:
-                self.visit_symbol_table(info.names, info.fullname)
-            if info.bases:
-                for base in info.bases:
-                    base.accept(self.type_fixer)
-            if info._promote:
-                for p in info._promote:
-                    p.accept(self.type_fixer)
-            if info.tuple_type:
-                info.tuple_type.accept(self.type_fixer)
-                info.update_tuple_type(info.tuple_type)
-                if info.special_alias:
-                    info.special_alias.alias_tvars = list(info.defn.type_vars)
-                    for i, t in enumerate(info.defn.type_vars):
-                        if isinstance(t, TypeVarTupleType):
-                            info.special_alias.tvar_tuple_index = i
-            if info.typeddict_type:
-                info.typeddict_type.accept(self.type_fixer)
-                info.update_typeddict_type(info.typeddict_type)
-                if info.special_alias:
-                    info.special_alias.alias_tvars = list(info.defn.type_vars)
-                    for i, t in enumerate(info.defn.type_vars):
-                        if isinstance(t, TypeVarTupleType):
-                            info.special_alias.tvar_tuple_index = i
-            if info.declared_metaclass:
-                info.declared_metaclass.accept(self.type_fixer)
-            if info.metaclass_type:
-                info.metaclass_type.accept(self.type_fixer)
-            if info.alt_promote:
-                info.alt_promote.accept(self.type_fixer)
-                instance = Instance(info, [])
-                # Hack: We may also need to add a backwards promotion (from int to native int),
-                # since it might not be serialized.
-                if instance not in info.alt_promote.type._promote:
-                    info.alt_promote.type._promote.append(instance)
-            if info._mro_refs:
-                info.mro = [
-                    lookup_fully_qualified_typeinfo(
-                        self.modules, name, allow_missing=self.allow_missing
-                    )
-                    for name in info._mro_refs
-                ]
-                info._mro_refs = None
-        finally:
-            self.current_info = save_info
-
-    # NOTE: This method *definitely* isn't part of the NodeVisitor API.
-    def visit_symbol_table(self, symtab: SymbolTable, table_fullname: str) -> None:
-        # Copy the items because we may mutate symtab.
-        for key, value in list(symtab.items()):
-            cross_ref = value.cross_ref
-            if cross_ref is not None:  # Fix up cross-reference.
-                value.cross_ref = None
-                if cross_ref in self.modules:
-                    value.node = self.modules[cross_ref]
-                else:
-                    stnode = lookup_fully_qualified(
-                        cross_ref, self.modules, raise_on_missing=not self.allow_missing
-                    )
-                    if stnode is not None:
-                        if stnode is value:
-                            # The node seems to refer to itself, which can mean that
-                            # the target is a deleted submodule of the current module,
-                            # and thus lookup falls back to the symbol table of the parent
-                            # package. Here's how this may happen:
-                            #
-                            #   pkg/__init__.py:
-                            #     from pkg import sub
-                            #
-                            # Now if pkg.sub is deleted, the pkg.sub symbol table entry
-                            # appears to refer to itself. Replace the entry with a
-                            # placeholder to avoid a crash. We can't delete the entry,
-                            # as it would stop dependency propagation.
-                            value.node = Var(key + "@deleted")
-                        else:
-                            assert stnode.node is not None, (table_fullname + "." + key, cross_ref)
-                            value.node = stnode.node
-                    elif not self.allow_missing:
-                        assert False, f"Could not find cross-ref {cross_ref}"
-                    else:
-                        # We have a missing crossref in allow missing mode, need to put something
-                        value.node = missing_info(self.modules)
-            else:
-                if isinstance(value.node, TypeInfo):
-                    # TypeInfo has no accept().  TODO: Add it?
-                    self.visit_type_info(value.node)
-                elif value.node is not None:
-                    value.node.accept(self)
-                else:
-                    assert False, f"Unexpected empty node {key!r}: {value}"
-
-    def visit_func_def(self, func: FuncDef) -> None:
-        if self.current_info is not None:
-            func.info = self.current_info
-        if func.type is not None:
-            func.type.accept(self.type_fixer)
-
-    def visit_overloaded_func_def(self, o: OverloadedFuncDef) -> None:
-        if self.current_info is not None:
-            o.info = self.current_info
-        if o.type:
-            o.type.accept(self.type_fixer)
-        for item in o.items:
-            item.accept(self)
-        if o.impl:
-            o.impl.accept(self)
-
-    def visit_decorator(self, d: Decorator) -> None:
-        if self.current_info is not None:
-            d.var.info = self.current_info
-        if d.func:
-            d.func.accept(self)
-        if d.var:
-            d.var.accept(self)
-        for node in d.decorators:
-            node.accept(self)
-
-    def visit_class_def(self, c: ClassDef) -> None:
-        for v in c.type_vars:
-            v.accept(self.type_fixer)
-
-    def visit_type_var_expr(self, tv: TypeVarExpr) -> None:
-        for value in tv.values:
-            value.accept(self.type_fixer)
-        tv.upper_bound.accept(self.type_fixer)
-        tv.default.accept(self.type_fixer)
-
-    def visit_paramspec_expr(self, p: ParamSpecExpr) -> None:
-        p.upper_bound.accept(self.type_fixer)
-        p.default.accept(self.type_fixer)
-
-    def visit_type_var_tuple_expr(self, tv: TypeVarTupleExpr) -> None:
-        tv.upper_bound.accept(self.type_fixer)
-        tv.tuple_fallback.accept(self.type_fixer)
-        tv.default.accept(self.type_fixer)
-
-    def visit_var(self, v: Var) -> None:
-        if self.current_info is not None:
-            v.info = self.current_info
-        if v.type is not None:
-            v.type.accept(self.type_fixer)
-
-    def visit_type_alias(self, a: TypeAlias) -> None:
-        a.target.accept(self.type_fixer)
-        for v in a.alias_tvars:
-            v.accept(self.type_fixer)
-
-
-class TypeFixer(TypeVisitor[None]):
-    def __init__(self, modules: dict[str, MypyFile], allow_missing: bool) -> None:
-        self.modules = modules
-        self.allow_missing = allow_missing
-
-    def visit_instance(self, inst: Instance) -> None:
-        # TODO: Combine Instances that are exactly the same?
-        type_ref = inst.type_ref
-        if type_ref is None:
-            return  # We've already been here.
-        inst.type_ref = None
-        inst.type = lookup_fully_qualified_typeinfo(
-            self.modules, type_ref, allow_missing=self.allow_missing
-        )
-        # TODO: Is this needed or redundant?
-        # Also fix up the bases, just in case.
-        for base in inst.type.bases:
-            if base.type is NOT_READY:
-                base.accept(self)
-        for a in inst.args:
-            a.accept(self)
-        if inst.last_known_value is not None:
-            inst.last_known_value.accept(self)
-
-    def visit_type_alias_type(self, t: TypeAliasType) -> None:
-        type_ref = t.type_ref
-        if type_ref is None:
-            return  # We've already been here.
-        t.type_ref = None
-        t.alias = lookup_fully_qualified_alias(
-            self.modules, type_ref, allow_missing=self.allow_missing
-        )
-        for a in t.args:
-            a.accept(self)
-
-    def visit_any(self, o: Any) -> None:
-        pass  # Nothing to descend into.
-
-    def visit_callable_type(self, ct: CallableType) -> None:
-        if ct.fallback:
-            ct.fallback.accept(self)
-        for argt in ct.arg_types:
-            # argt may be None, e.g. for __self in NamedTuple constructors.
-            if argt is not None:
-                argt.accept(self)
-        if ct.ret_type is not None:
-            ct.ret_type.accept(self)
-        for v in ct.variables:
-            v.accept(self)
-        for arg in ct.bound_args:
-            if arg:
-                arg.accept(self)
-        if ct.type_guard is not None:
-            ct.type_guard.accept(self)
-        if ct.type_is is not None:
-            ct.type_is.accept(self)
-
-    def visit_overloaded(self, t: Overloaded) -> None:
-        for ct in t.items:
-            ct.accept(self)
-
-    def visit_erased_type(self, o: Any) -> None:
-        # This type should exist only temporarily during type inference
-        raise RuntimeError("Shouldn't get here", o)
-
-    def visit_deleted_type(self, o: Any) -> None:
-        pass  # Nothing to descend into.
-
-    def visit_none_type(self, o: Any) -> None:
-        pass  # Nothing to descend into.
-
-    def visit_uninhabited_type(self, o: Any) -> None:
-        pass  # Nothing to descend into.
-
-    def visit_partial_type(self, o: Any) -> None:
-        raise RuntimeError("Shouldn't get here", o)
-
-    def visit_tuple_type(self, tt: TupleType) -> None:
-        if tt.items:
-            for it in tt.items:
-                it.accept(self)
-        if tt.partial_fallback is not None:
-            tt.partial_fallback.accept(self)
-
-    def visit_typeddict_type(self, tdt: TypedDictType) -> None:
-        if tdt.items:
-            for it in tdt.items.values():
-                it.accept(self)
-        if tdt.fallback is not None:
-            if tdt.fallback.type_ref is not None:
-                if (
-                    lookup_fully_qualified(
-                        tdt.fallback.type_ref,
-                        self.modules,
-                        raise_on_missing=not self.allow_missing,
-                    )
-                    is None
-                ):
-                    # We reject fake TypeInfos for TypedDict fallbacks because
-                    # the latter are used in type checking and must be valid.
-                    tdt.fallback.type_ref = "typing._TypedDict"
-            tdt.fallback.accept(self)
-
-    def visit_literal_type(self, lt: LiteralType) -> None:
-        lt.fallback.accept(self)
-
-    def visit_type_var(self, tvt: TypeVarType) -> None:
-        if tvt.values:
-            for vt in tvt.values:
-                vt.accept(self)
-        tvt.upper_bound.accept(self)
-        tvt.default.accept(self)
-
-    def visit_param_spec(self, p: ParamSpecType) -> None:
-        p.upper_bound.accept(self)
-        p.default.accept(self)
-
-    def visit_type_var_tuple(self, t: TypeVarTupleType) -> None:
-        t.tuple_fallback.accept(self)
-        t.upper_bound.accept(self)
-        t.default.accept(self)
-
-    def visit_unpack_type(self, u: UnpackType) -> None:
-        u.type.accept(self)
-
-    def visit_parameters(self, p: Parameters) -> None:
-        for argt in p.arg_types:
-            if argt is not None:
-                argt.accept(self)
-        for var in p.variables:
-            var.accept(self)
-
-    def visit_unbound_type(self, o: UnboundType) -> None:
-        for a in o.args:
-            a.accept(self)
-
-    def visit_union_type(self, ut: UnionType) -> None:
-        if ut.items:
-            for it in ut.items:
-                it.accept(self)
-
-    def visit_type_type(self, t: TypeType) -> None:
-        t.item.accept(self)
-
-
-def lookup_fully_qualified_typeinfo(
-    modules: dict[str, MypyFile], name: str, *, allow_missing: bool
-) -> TypeInfo:
-    stnode = lookup_fully_qualified(name, modules, raise_on_missing=not allow_missing)
-    node = stnode.node if stnode else None
-    if isinstance(node, TypeInfo):
-        return node
-    else:
-        # Looks like a missing TypeInfo during an initial daemon load, put something there
-        assert (
-            allow_missing
-        ), "Should never get here in normal mode, got {}:{} instead of TypeInfo".format(
-            type(node).__name__, node.fullname if node else ""
-        )
-        return missing_info(modules)
-
-
-def lookup_fully_qualified_alias(
-    modules: dict[str, MypyFile], name: str, *, allow_missing: bool
-) -> TypeAlias:
-    stnode = lookup_fully_qualified(name, modules, raise_on_missing=not allow_missing)
-    node = stnode.node if stnode else None
-    if isinstance(node, TypeAlias):
-        return node
-    elif isinstance(node, TypeInfo):
-        if node.special_alias:
-            # Already fixed up.
-            return node.special_alias
-        if node.tuple_type:
-            alias = TypeAlias.from_tuple_type(node)
-        elif node.typeddict_type:
-            alias = TypeAlias.from_typeddict_type(node)
-        else:
-            assert allow_missing
-            return missing_alias()
-        node.special_alias = alias
-        return alias
-    else:
-        # Looks like a missing TypeAlias during an initial daemon load, put something there
-        assert (
-            allow_missing
-        ), "Should never get here in normal mode, got {}:{} instead of TypeAlias".format(
-            type(node).__name__, node.fullname if node else ""
-        )
-        return missing_alias()
-
-
-_SUGGESTION: Final = "<missing {}: *should* have gone away during fine-grained update>"
-
-
-def missing_info(modules: dict[str, MypyFile]) -> TypeInfo:
-    suggestion = _SUGGESTION.format("info")
-    dummy_def = ClassDef(suggestion, Block([]))
-    dummy_def.fullname = suggestion
-
-    info = TypeInfo(SymbolTable(), dummy_def, "<missing>")
-    obj_type = lookup_fully_qualified_typeinfo(modules, "builtins.object", allow_missing=False)
-    info.bases = [Instance(obj_type, [])]
-    info.mro = [info, obj_type]
-    return info
-
-
-def missing_alias() -> TypeAlias:
-    suggestion = _SUGGESTION.format("alias")
-    return TypeAlias(AnyType(TypeOfAny.special_form), suggestion, line=-1, column=-1)

jaclang/vendor/mypy/freetree.py

@@ -1,23 +0,0 @@
-"""Generic node traverser visitor"""
-
-from __future__ import annotations
-
-from mypy.nodes import Block, MypyFile
-from mypy.traverser import TraverserVisitor
-
-
-class TreeFreer(TraverserVisitor):
-    def visit_block(self, block: Block) -> None:
-        super().visit_block(block)
-        block.body.clear()
-
-
-def free_tree(tree: MypyFile) -> None:
-    """Free all the ASTs associated with a module.
-
-    This needs to be done recursively, since symbol tables contain
-    references to definitions, so those won't be freed but we want their
-    contents to be.
-    """
-    tree.accept(TreeFreer())
-    tree.defs.clear()