py2docfx 0.1.13rc2012291__py3-none-any.whl → 0.1.13rc2022156__py3-none-any.whl

py2docfx/venv/basevenv/Lib/site-packages/setuptools/_distutils/filelist.py

@@ -4,10 +4,14 @@ Provides the FileList class, used for poking about the filesystem
 and building lists of files.
 """
 
+from __future__ import annotations
+
 import fnmatch
 import functools
 import os
 import re
+from collections.abc import Iterable
+from typing import Literal, overload
 
 from ._log import log
 from .errors import DistutilsInternalError, DistutilsTemplateError
@@ -29,19 +33,19 @@ class FileList:
         filtering applied)
     """
 
-    def __init__(self, warn=None, debug_print=None):
+    def __init__(self, warn: object = None, debug_print: object = None) -> None:
         # ignore argument to FileList, but keep them for backwards
         # compatibility
-        self.allfiles = None
-        self.files = []
+        self.allfiles: Iterable[str] | None = None
+        self.files: list[str] = []
 
-    def set_allfiles(self, allfiles):
+    def set_allfiles(self, allfiles: Iterable[str]) -> None:
         self.allfiles = allfiles
 
-    def findall(self, dir=os.curdir):
+    def findall(self, dir: str | os.PathLike[str] = os.curdir) -> None:
         self.allfiles = findall(dir)
 
-    def debug_print(self, msg):
+    def debug_print(self, msg: object) -> None:
         """Print 'msg' to stdout if the global DEBUG (taken from the
         DISTUTILS_DEBUG environment variable) flag is true.
         """
@@ -52,13 +56,13 @@ class FileList:
 
     # Collection methods
 
-    def append(self, item):
+    def append(self, item: str) -> None:
         self.files.append(item)
 
-    def extend(self, items):
+    def extend(self, items: Iterable[str]) -> None:
         self.files.extend(items)
 
-    def sort(self):
+    def sort(self) -> None:
         # Not a strict lexical sort!
         sortable_files = sorted(map(os.path.split, self.files))
         self.files = []
@@ -67,7 +71,7 @@ class FileList:
 
     # Other miscellaneous utility methods
 
-    def remove_duplicates(self):
+    def remove_duplicates(self) -> None:
         # Assumes list has been sorted!
         for i in range(len(self.files) - 1, 0, -1):
             if self.files[i] == self.files[i - 1]:
@@ -105,7 +109,7 @@ class FileList:
 
         return (action, patterns, dir, dir_pattern)
 
-    def process_template_line(self, line):  # noqa: C901
+    def process_template_line(self, line: str) -> None:  # noqa: C901
         # Parse the line: split it up, make sure the right number of words
         # is there, and return the relevant words.  'action' is always
         # defined: it's the first word of the line.  Which of the other
@@ -193,8 +197,38 @@ class FileList:
             )
 
     # Filtering/selection methods
-
-    def include_pattern(self, pattern, anchor=True, prefix=None, is_regex=False):
+    @overload
+    def include_pattern(
+        self,
+        pattern: str,
+        anchor: bool = True,
+        prefix: str | None = None,
+        is_regex: Literal[False] = False,
+    ) -> bool: ...
+    @overload
+    def include_pattern(
+        self,
+        pattern: str | re.Pattern[str],
+        anchor: bool = True,
+        prefix: str | None = None,
+        *,
+        is_regex: Literal[True],
+    ) -> bool: ...
+    @overload
+    def include_pattern(
+        self,
+        pattern: str | re.Pattern[str],
+        anchor: bool,
+        prefix: str | None,
+        is_regex: Literal[True],
+    ) -> bool: ...
+    def include_pattern(
+        self,
+        pattern: str | re.Pattern,
+        anchor: bool = True,
+        prefix: str | None = None,
+        is_regex: bool = False,
+    ) -> bool:
         """Select strings (presumably filenames) from 'self.files' that
         match 'pattern', a Unix-style wildcard (glob) pattern.  Patterns
         are not quite the same as implemented by the 'fnmatch' module: '*'
@@ -235,7 +269,38 @@ class FileList:
                 files_found = True
         return files_found
 
-    def exclude_pattern(self, pattern, anchor=True, prefix=None, is_regex=False):
+    @overload
+    def exclude_pattern(
+        self,
+        pattern: str,
+        anchor: bool = True,
+        prefix: str | None = None,
+        is_regex: Literal[False] = False,
+    ) -> bool: ...
+    @overload
+    def exclude_pattern(
+        self,
+        pattern: str | re.Pattern[str],
+        anchor: bool = True,
+        prefix: str | None = None,
+        *,
+        is_regex: Literal[True],
+    ) -> bool: ...
+    @overload
+    def exclude_pattern(
+        self,
+        pattern: str | re.Pattern[str],
+        anchor: bool,
+        prefix: str | None,
+        is_regex: Literal[True],
+    ) -> bool: ...
+    def exclude_pattern(
+        self,
+        pattern: str | re.Pattern,
+        anchor: bool = True,
+        prefix: str | None = None,
+        is_regex: bool = False,
+    ) -> bool:
         """Remove strings (presumably filenames) from 'files' that match
         'pattern'.  Other parameters are the same as for
         'include_pattern()', above.
@@ -294,7 +359,7 @@ class _UniqueDirs(set):
         return filter(cls(), items)
 
 
-def findall(dir=os.curdir):
+def findall(dir: str | os.PathLike[str] = os.curdir):
     """
     Find all files under 'dir' and return the list of full filenames.
     Unless dir is '.', return full filenames with dir prepended.

py2docfx/venv/basevenv/Lib/site-packages/setuptools/_distutils/spawn.py

@@ -12,12 +12,19 @@ import shutil
 import subprocess
 import sys
 import warnings
-from collections.abc import Mapping
+from collections.abc import Mapping, MutableSequence
+from typing import TYPE_CHECKING, TypeVar, overload
 
 from ._log import log
 from .debug import DEBUG
 from .errors import DistutilsExecError
 
+if TYPE_CHECKING:
+    from subprocess import _ENV
+
+
+_MappingT = TypeVar("_MappingT", bound=Mapping)
+
 
 def _debug(cmd):
     """
@@ -26,7 +33,7 @@ def _debug(cmd):
     return cmd if DEBUG else cmd[0]
 
 
-def _inject_macos_ver(env: Mapping[str:str] | None) -> Mapping[str:str] | None:
+def _inject_macos_ver(env: _MappingT | None) -> _MappingT | dict[str, str | int] | None:
     if platform.system() != 'Darwin':
         return env
 
@@ -37,11 +44,21 @@ def _inject_macos_ver(env: Mapping[str:str] | None) -> Mapping[str:str] | None:
     return {**_resolve(env), **update}
 
 
-def _resolve(env: Mapping[str:str] | None) -> Mapping[str:str]:
+@overload
+def _resolve(env: None) -> os._Environ[str]: ...
+@overload
+def _resolve(env: _MappingT) -> _MappingT: ...
+def _resolve(env: _MappingT | None) -> _MappingT | os._Environ[str]:
     return os.environ if env is None else env
 
 
-def spawn(cmd, search_path=True, verbose=False, dry_run=False, env=None):
+def spawn(
+    cmd: MutableSequence[bytes | str | os.PathLike[str]],
+    search_path: bool = True,
+    verbose: bool = False,
+    dry_run: bool = False,
+    env: _ENV | None = None,
+) -> None:
     """Run another program, specified as a command list 'cmd', in a new process.
 
     'cmd' is just the argument list for the new process, ie.
@@ -78,7 +95,7 @@ def spawn(cmd, search_path=True, verbose=False, dry_run=False, env=None):
         ) from err
 
 
-def find_executable(executable, path=None):
+def find_executable(executable: str, path: str | None = None) -> str | None:
     """Tries to find 'executable' in the directories listed in 'path'.
 
     A string listing directories separated by 'os.pathsep'; defaults to

py2docfx/venv/basevenv/Lib/site-packages/setuptools/_distutils/sysconfig.py

@@ -9,19 +9,31 @@ Written by:   Fred L. Drake, Jr.
 Email:        <fdrake@acm.org>
 """
 
+from __future__ import annotations
+
 import functools
 import os
 import pathlib
 import re
 import sys
 import sysconfig
+from typing import TYPE_CHECKING, Literal, overload
 
 from jaraco.functools import pass_none
 
+from .ccompiler import CCompiler
 from .compat import py39
 from .errors import DistutilsPlatformError
 from .util import is_mingw
 
+if TYPE_CHECKING:
+    from typing_extensions import deprecated
+else:
+
+    def deprecated(message):
+        return lambda fn: fn
+
+
 IS_PYPY = '__pypy__' in sys.builtin_module_names
 
 # These are needed in a couple of spots, so just compute them once.
@@ -110,7 +122,7 @@ def get_python_version():
     return f'{sys.version_info.major}.{sys.version_info.minor}'
 
 
-def get_python_inc(plat_specific=False, prefix=None):
+def get_python_inc(plat_specific: bool = False, prefix: str | None = None) -> str:
     """Return the directory containing installed Python header files.
 
     If 'plat_specific' is false (the default), this is the path to the
@@ -217,7 +229,9 @@ def _posix_lib(standard_lib, libpython, early_prefix, prefix):
         return os.path.join(libpython, "site-packages")
 
 
-def get_python_lib(plat_specific=False, standard_lib=False, prefix=None):
+def get_python_lib(
+    plat_specific: bool = False, standard_lib: bool = False, prefix: str | None = None
+) -> str:
     """Return the directory containing the Python library (standard or
     site additions).
 
@@ -288,7 +302,7 @@ def _customize_macos():
     )
 
 
-def customize_compiler(compiler):
+def customize_compiler(compiler: CCompiler) -> None:
     """Do any platform-specific customization of a CCompiler instance.
 
     Mainly needed on Unix, so we can plug in the information that
@@ -375,12 +389,12 @@ def customize_compiler(compiler):
         compiler.shared_lib_extension = shlib_suffix
 
 
-def get_config_h_filename():
+def get_config_h_filename() -> str:
     """Return full pathname of installed pyconfig.h file."""
     return sysconfig.get_config_h_filename()
 
 
-def get_makefile_filename():
+def get_makefile_filename() -> str:
     """Return full pathname of installed Makefile from the Python build."""
     return sysconfig.get_makefile_filename()
 
@@ -542,7 +556,11 @@ def expand_makefile_vars(s, vars):
 _config_vars = None
 
 
-def get_config_vars(*args):
+@overload
+def get_config_vars() -> dict[str, str | int]: ...
+@overload
+def get_config_vars(arg: str, /, *args: str) -> list[str | int]: ...
+def get_config_vars(*args: str) -> list[str | int] | dict[str, str | int]:
     """With no arguments, return a dictionary of all configuration
     variables relevant for the current platform.  Generally this includes
     everything needed to build extensions and install both pure modules and
@@ -560,7 +578,14 @@ def get_config_vars(*args):
     return [_config_vars.get(name) for name in args] if args else _config_vars
 
 
-def get_config_var(name):
+@overload
+@deprecated(
+    "SO is deprecated, use EXT_SUFFIX. Support will be removed when this module is synchronized with stdlib Python 3.11"
+)
+def get_config_var(name: Literal["SO"]) -> int | str | None: ...
+@overload
+def get_config_var(name: str) -> int | str | None: ...
+def get_config_var(name: str) -> int | str | None:
     """Return the value of a single variable using the dictionary
     returned by 'get_config_vars()'.  Equivalent to
     get_config_vars().get(name)

py2docfx/venv/basevenv/Lib/site-packages/setuptools/_distutils/tests/test_build_ext.py

@@ -345,6 +345,19 @@ class TestBuildExt(TempdirManager):
         assert cmd.get_export_symbols(modules[0]) == ['PyInit_foo']
         assert cmd.get_export_symbols(modules[1]) == ['PyInitU_f_1gaa']
 
+    def test_export_symbols__init__(self):
+        # https://github.com/python/cpython/issues/80074
+        # https://github.com/pypa/setuptools/issues/4826
+        modules = [
+            Extension('foo.__init__', ['aaa']),
+            Extension('föö.__init__', ['uuu']),
+        ]
+        dist = Distribution({'name': 'xx', 'ext_modules': modules})
+        cmd = self.build_ext(dist)
+        cmd.ensure_finalized()
+        assert cmd.get_export_symbols(modules[0]) == ['PyInit_foo']
+        assert cmd.get_export_symbols(modules[1]) == ['PyInitU_f_1gaa']
+
     def test_compiler_option(self):
         # cmd.compiler is an option and
         # should not be overridden by a compiler instance

py2docfx/venv/basevenv/Lib/site-packages/setuptools/_distutils/tests/test_sdist.py

@@ -270,7 +270,7 @@ class TestSDist(support.TempdirManager):
         caplog.clear()
         dist, cmd = self.get_cmd()
         cmd.ensure_finalized()
-        cmd.metadata_check = 0
+        cmd.metadata_check = False
         cmd.run()
         assert len(self.warnings(caplog.messages, 'warning: check: ')) == 0